ማጣቀሻ · ቲቪዎች

ቲቪዎችን መዘርዘር

GET /v1/tvs

ተጠቃሚው ቲቪዎችን ማየት በሚችልባቸው ድርጅቶች ውስጥ ያሉትን የነቁ ቲቪዎች በፊደል ቅደም ተከተል ይዘረዝራል።

በገጾች የተከፋፈለ ምላሽ፦ ንጥሎቹ በdata ውስጥ፣ የገጹ መረጃ ደግሞ በmeta ውስጥ ይመጣሉ። ገጽ መከፋፈል እና ማጣሪያዎች

ፓራሜትሮች

ስም	አይነት	መግለጫ
`organization`	`string`	የአንድ ድርጅት uid፣ የእሱን ንጥሎች ብቻ ለማምጣት (`/organizations`ን ይመልከቱ)።
`q`	`string`	የስሙ ክፍል፣ እስከ 100 ቁምፊዎች።
`page`	`integer`	ገጽ፣ ከ1 ጀምሮ። ነባሪ፦ 1።
`per_page`	`integer`	በአንድ ገጽ ያሉ ንጥሎች፣ ከ1 እስከ 100። ነባሪ፦ 50።

የእያንዳንዱ ንጥል መስኮች

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 ደቂቃ ወይም ከዚያ በላይ ግንኙነት የለም፣ ወይም ፈጽሞ አልተገናኘም

በቁጥጥር ፓነሉ ውስጥ ያሉት የሁኔታ ቀለሞች የሚከተሉት ያው ደንብ ነው።

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

400 invalid_parameter አንድ ፓራሜትር ልክ ያልሆነ ዋጋ አለው፤ ለምሳሌ ከከፍተኛው በላይ የሆነ per_page።
404 organization_not_found የተሰጠው organization ተጠቃሚው ይህን አይነት ንጥል ማየት የሚችልበት ድርጅት አይደለም።
የቁልፍ እና የገደብ ስህተቶች ለሁሉም ኢንድፖይንቶች ይሠራሉ። ሁሉንም ስህተቶች ይመልከቱ

ጥያቄcURLPHPJavaScript

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

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

ምላሽ200

{
  "data": [
    {
      "uid": "d3d9446802a44259755d38e6d163e820",
      "name": "Caixa 2",
      "description": "",
      "organization": {
        "uid": "1679091c5a880faf6fb5e6087eb1b2dc",
        "name": "Loja Shopping Norte"
      },
      "playlist": null,
      "status": "offline",
      "last_seen_at": "2026-11-01T18:04:51-03:00",
      "activated_at": "2025-03-12T09:41:05-03:00",
      "app_version": "3.12.83",
      "os": "android",
      "device": {
        "brand": "Philco",
        "model": "PTV32G70"
      },
      "timezone": "America/Sao_Paulo"
    },
    {
      "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"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 2,
    "total": 3,
    "total_pages": 2
  }
}