Žinynas · Televizoriai

Televizoriaus duomenys

GET /v1/tvs/{uid}

Grąžina televizorių pagal uid.

Kelio parametras

Pavadinimas	Tipas	Aprašymas
`uid`	`string`	Televizoriaus uid.

Atsakymo laukai

uid string: Televizoriaus identifikatorius – tas pats, kuris naudojamas valdymo skydelyje.
name string: Televizoriaus pavadinimas.
description string: Televizoriaus aprašymas (gali būti tuščias).
organization object: Televizoriaus organizacija: uid ir name.
playlist object | null: Televizoriaus grojaraštis (uid ir name) arba null, jei jo nėra.
status string: online, alert arba offline, kaip paaiškinta toliau.
last_seen_at string | null: Paskutinis televizoriaus ryšys su platforma arba null, jei jis niekada nebuvo prisijungęs.
activated_at string | null: Kada televizorius buvo suaktyvintas.
app_version string: Televizoriuje įdiegtos programėlės versija.
os string: Televizoriaus operacinė sistema, pavyzdžiui, android.
device object: Įrenginio prekės ženklas (brand) ir modelis (model), jei televizorius juos praneša.
timezone string | null: Televizoriaus laiko juosta, pavyzdžiui, America/Sao_Paulo, arba null.

Kaip apskaičiuojama būsena

online paskutinis ryšys mažiau nei prieš 3 minutes, turinys rodomas
alert paskutinis ryšys prieš 3–9 minutes arba televizorius dar paleidžiamas
offline nėra ryšio 10 minučių ar ilgiau arba televizorius niekada nebuvo prisijungęs

Tai ta pati taisyklė, pagal kurią valdymo skydelyje parenkamos būsenos spalvos.

Galimos klaidos

404 not_found Galinis taškas neegzistuoja arba elementas neegzistuoja ar priklauso organizacijai, kurios naudotojas negali matyti.
Rakto ir apribojimų klaidos galioja visiems galiniams taškams. Žiūrėti visas klaidas

UžklausacURLPHPJavaScript

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

Atsakymas200

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

Elementas neegzistuoja arba nėra prieigos404

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