রেফারেন্স · টিভি

একটি টিভি দেখুন

GET /v1/tvs/{uid}

uid অনুযায়ী একটি টিভি দেখায়।

পাথ প্যারামিটার

নাম	ধরন	বিবরণ
`uid`	`string`	টিভির uid।

রেসপন্সের ফিল্ড

uid string: টিভির শনাক্তকারী, কন্ট্রোল প্যানেলে ব্যবহৃত শনাক্তকারীর মতোই।
name string: টিভির নাম।
description string: টিভির বিবরণ (খালি থাকতে পারে)।
organization object: টিভির প্রতিষ্ঠান: uid ও name।
playlist object | null: টিভির প্লেলিস্ট (uid ও name), অথবা না থাকলে null।
status string: online, alert বা offline, নিচে যেমন ব্যাখ্যা করা হয়েছে।
last_seen_at string | null: প্ল্যাটফর্মের সঙ্গে টিভির সর্বশেষ যোগাযোগ, অথবা কখনো সংযুক্ত না হলে null।
activated_at string | null: টিভি কখন সক্রিয় করা হয়েছে।
app_version string: টিভিতে ইনস্টল করা অ্যাপের ভার্সন।
os string: টিভির অপারেটিং সিস্টেম, যেমন android।
device object: ডিভাইসের ব্র্যান্ড (brand) ও মডেল (model), যদি টিভি তা জানায়।
timezone string | null: টিভির টাইম জোন, যেমন America/Sao_Paulo, অথবা null।

স্ট্যাটাস যেভাবে নির্ধারিত হয়

online 3 মিনিটের কম আগে যোগাযোগ, প্লে হচ্ছে
alert 3 থেকে 9 মিনিট আগে যোগাযোগ, অথবা টিভি এখনো চালু হচ্ছে
offline 10 মিনিট বা তার বেশি সময় ধরে যোগাযোগ নেই, অথবা কখনো সংযুক্ত হয়নি

কন্ট্রোল প্যানেলের স্ট্যাটাসের রঙের ক্ষেত্রেও একই নিয়ম প্রযোজ্য।

সম্ভাব্য ত্রুটি

404 not_found এন্ডপয়েন্টটির অস্তিত্ব নেই, অথবা আইটেমটির অস্তিত্ব নেই বা এটি এমন প্রতিষ্ঠানের, যা ব্যবহারকারী দেখতে পারেন না।
কী ও সীমা-সংক্রান্ত ত্রুটিগুলো সব এন্ডপয়েন্টে প্রযোজ্য। সব ত্রুটি দেখুন

অনুরোধcURLPHPJavaScript

curl "https://api.on-cloud.live/v1/tvs/c98cb8f9cc62887d1f6cf5693df9219c" \
  -H "X-API-Key: $API_KEY"

<?php
$ch = curl_init('https://api.on-cloud.live/v1/tvs/c98cb8f9cc62887d1f6cf5693df9219c');
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/tvs/c98cb8f9cc62887d1f6cf5693df9219c', {
  headers: { 'X-API-Key': process.env.API_KEY }
});
const { data } = await res.json();

রেসপন্স200

{
  "data": {
    "uid": "c98cb8f9cc62887d1f6cf5693df9219c",
    "name": "Recepção",
    "description": "TV da entrada",
    "organization": {
      "uid": "8f14e45fceea167a5a36dedd4bea2543",
      "name": "Loja Centro"
    },
    "playlist": {
      "uid": "e4da3b7fbbce2345d7772b0674a318d5",
      "name": "Lista principal"
    },
    "status": "online",
    "last_seen_at": "2026-11-03T14:32:10-03:00",
    "activated_at": "2025-03-12T09:41:05-03:00",
    "app_version": "3.12.84",
    "os": "android",
    "device": {
      "brand": "TCL",
      "model": "43P635"
    },
    "timezone": "America/Sao_Paulo"
  }
}

অস্তিত্বহীন বা অ্যাক্সেস নেই এমন আইটেম404

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}