ማጣቀሻ · ቲቪዎች

አንድ ቲቪ ማየት

አንድ ቲቪን በ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።

ሊከሰቱ የሚችሉ ስህተቶች

• 404 not_found ኢንድፖይንቱ የለም፤ ወይም ንጥሉ የለም ወይም ተጠቃሚው ማየት የማይችለው ድርጅት ንብረት ነው።
• የቁልፍ እና የገደብ ስህተቶች ለሁሉም ኢንድፖይንቶች ይሠራሉ። ሁሉንም ስህተቶች ይመልከቱ

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();

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

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