संदर्भ · टीवी

एक टीवी देखें

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