Referenca · Televizorji

Podrobnosti televizorja

GET /v1/tvs/{uid}

Vrne televizor glede na uid.

Parameter poti

Ime	Vrsta	Opis
`uid`	`string`	uid televizorja.

Polja odgovora

uid string: Identifikator televizorja, enak kot na nadzorni plošči.
name string: Ime televizorja.
description string: Opis televizorja (lahko je prazen).
organization object: Organizacija televizorja: uid in name.
playlist object | null: Seznam predvajanja televizorja (uid in name) ali null, če ga ni.
status string: online, alert ali offline, kot je pojasnjeno spodaj.
last_seen_at string | null: Zadnji stik televizorja s platformo ali null, če se ni nikoli povezal.
activated_at string | null: Kdaj je bil televizor aktiviran.
app_version string: Različica aplikacije, nameščene na televizorju.
os string: Operacijski sistem televizorja, na primer android.
device object: Znamka (brand) in model (model) naprave, če ju televizor sporoči.
timezone string | null: Časovni pas televizorja, na primer America/Sao_Paulo, ali null.

Kako se izračuna stanje

online stik pred manj kot 3 minutami, predvaja
alert stik pred 3 do 9 minutami ali televizor se še zaganja
offline brez stika 10 minut ali dlje oziroma se ni nikoli povezal

Gre za enako pravilo kot pri barvah stanja na nadzorni plošči.

Možne napake

404 not_found Končna točka ne obstaja ali pa element ne obstaja oziroma pripada organizaciji, ki je uporabnik ne more videti.
Napake ključa in omejitve zahtev veljajo za vse končne točke. Prikaži vse napake

ZahtevacURLPHPJavaScript

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

Odgovor200

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

Element ne obstaja ali ni dostopa404

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