Referenca · TV uređaji

Podaci o TV uređaju

GET /v1/tvs/{uid}

Prikazuje TV uređaj s navedenim uid.

Parametar u putanji

Naziv	Tip	Opis
`uid`	`string`	uid TV uređaja.

Polja odgovora

uid string: Identifikator TV uređaja, isti kao na kontrolnoj ploči.
name string: Naziv TV uređaja.
description string: Opis TV uređaja (može biti prazan).
organization object: Organizacija TV uređaja: uid i name.
playlist object | null: Playlista TV uređaja (uid i name) ili null ako je nema.
status string: online, alert ili offline, kako je objašnjeno ispod.
last_seen_at string | null: Posljednji kontakt TV uređaja s platformom ili null ako se nikada nije povezao.
activated_at string | null: Kada je TV uređaj aktiviran.
app_version string: Verzija aplikacije instalirane na TV uređaju.
os string: Operativni sistem TV uređaja, npr. android.
device object: Marka (brand) i model (model) uređaja, kada ih TV uređaj prijavi.
timezone string | null: Vremenska zona TV uređaja, npr. America/Sao_Paulo, ili null.

Kako se izračunava status

online kontakt prije manje od 3 minute, reprodukcija je u toku
alert kontakt prije 3 do 9 minuta ili se TV uređaj još pokreće
offline nema kontakta 10 minuta ili duže ili se nikada nije povezao

Isto pravilo važi za boje statusa na kontrolnoj ploči.

Moguće greške

404 not_found Endpoint ne postoji, ili stavka ne postoji ili pripada organizaciji koju korisnik ne može vidjeti.
Greške vezane za ključ i ograničenje zahtjeva važe za sve endpointe. Pogledaj sve greške

ZahtjevcURLPHPJavaScript

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

Stavka ne postoji ili nema pristupa404

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