শুরু করুন
প্রত্যেক ব্যবহারকারী যা দেখতে পান
কী ঠিক ততটুকুই দেখে, যতটুকু এর ব্যবহারকারী কন্ট্রোল প্যানেলে দেখেন। API-তে কিছুই কনফিগার করতে হয় না: নিয়মগুলো আসে ব্যবহারকারীর প্রতিষ্ঠান ও অনুমতি থেকে।
শুধু ব্যবহারকারীর প্রতিষ্ঠান
API শুধু ব্যবহারকারীর সঙ্গে যুক্ত প্রতিষ্ঠানগুলো বিবেচনা করে, অর্থাৎ কন্ট্রোল প্যানেলে তিনি যেগুলো বেছে নিতে পারেন।
প্রশাসক প্রতিষ্ঠানের সবকিছু দেখেন
যিনি প্রতিষ্ঠানের বা প্রধান প্রতিষ্ঠানের প্রশাসক, তিনি সেই প্রতিষ্ঠানের সব টিভি, ফাইল ও প্লেলিস্ট দেখতে পান।
অন্যদের ক্ষেত্রে অনুমতির ওপর নির্ভর করে
অন্য ব্যবহারকারীদের ক্ষেত্রে প্রতিটি প্রতিষ্ঠানে টিভি, ফাইল ও প্লেলিস্ট দেখার অনুমতিগুলো প্রযোজ্য, অর্থাৎ যে অনুমতিগুলো কন্ট্রোল প্যানেলে এই পেজগুলো খুলে দেয়।
পরিবর্তন সঙ্গে সঙ্গে কার্যকর হয়
কন্ট্রোল প্যানেলে অনুমতি সরিয়ে নেওয়া, প্রতিষ্ঠান সরানো বা ব্যবহারকারী নিষ্ক্রিয় করা পরের অনুরোধ থেকেই কার্যকর হয়।
যা বাদ থাকে
- যেসব প্রতিষ্ঠানে অনুমতি নেই, সেগুলোর আইটেম তালিকায় দেখা যায় না। এর কোনোটি সরাসরি চাইলে
404আসে, যেন সেটির অস্তিত্বই নেই। - প্লেলিস্টে, যে ফাইল ব্যবহারকারী দেখতে পারেন না, সেটির
file-এর মান হয়null। কোনো প্লেলিস্টের টিভি এবং কোনো ফাইলের প্লেলিস্টে শুধু সেগুলোই দেখা যায়, যা ব্যবহারকারী দেখতে পারেন। - মুছে ফেলা আইটেম এবং এখনো সক্রিয় না হওয়া টিভি দেখা যায় না।
কোনো কী যা যা দেখতে পারে তা জানতে /organizations কল করুন: প্রতিটি প্রতিষ্ঠানের সঙ্গে admin ও permissions আসে।
আপনার সিস্টেমের যদি তথ্যের শুধু একটি অংশ দরকার হয়, তাহলে কন্ট্রোল প্যানেলে শুধু প্রয়োজনীয় অনুমতি দিয়ে এর জন্য আলাদা একজন ব্যবহারকারী তৈরি করুন এবং সেই ব্যবহারকারীর অ্যাকাউন্টে কী তৈরি করুন।
curl "https://api.on-cloud.live/v1/organizations" \
-H "X-API-Key: $API_KEY"<?php
$ch = curl_init('https://api.on-cloud.live/v1/organizations');
curl_setopt_array($ch, [
CURLOPT_RETURNTRANSFER => true,
CURLOPT_HTTPHEADER => ['X-API-Key: ' . getenv('API_KEY')],
]);
$response = json_decode(curl_exec($ch), true);const res = await fetch('https://api.on-cloud.live/v1/organizations', {
headers: { 'X-API-Key': process.env.API_KEY }
});
const { data } = await res.json();{
"data": [
{
"uid": "8f14e45fceea167a5a36dedd4bea2543",
"name": "Loja Centro",
"neutral_zone": false,
"admin": true,
"permissions": {
"tvs": true,
"files": true,
"playlists": true
}
},
{
"uid": "1679091c5a880faf6fb5e6087eb1b2dc",
"name": "Loja Shopping Norte",
"neutral_zone": false,
"admin": true,
"permissions": {
"tvs": true,
"files": true,
"playlists": true
}
}
]
}{
"error": {
"code": "not_found",
"message": "Item not found or you do not have access to it."
}
}