सन्दर्भ · टिभीहरू

एउटा टिभी हेर्नुहोस्

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."
  }
}