Referenca · Televizorji

Pregled televizorjev

GET /v1/tvs

Vrne aktivirane televizorje organizacij, v katerih lahko uporabnik vidi televizorje, po abecednem vrstnem redu.

Odgovor, razdeljen na strani: elementi so v data, podatki o strani pa v meta. Ostranjevanje in filtri

Parametri

Ime	Vrsta	Opis
`organization`	`string`	uid organizacije, če želite samo njene elemente (glejte `/organizations`).
`q`	`string`	Del imena, največ 100 znakov.
`page`	`integer`	Stran, od 1 naprej. Privzeto: 1.
`per_page`	`integer`	Število elementov na stran, od 1 do 100. Privzeto: 50.

Polja posameznega elementa

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

400 invalid_parameter Parameter ima neveljavno vrednost, na primer per_page nad največjo dovoljeno vrednostjo.
404 organization_not_found Podana vrednost organization ni organizacija, v kateri lahko uporabnik vidi to vrsto elementov.
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?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();

Odgovor200

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