Referenca · TV uređaji

Spisak TV uređaja

GET /v1/tvs

Prikazuje abecednim redom aktivirane TV uređaje organizacija u kojima korisnik može vidjeti TV uređaje.

Odgovor podijeljen na stranice: stavke stižu u data, a podaci o stranici u meta. Paginacija i filteri

Parametri

Naziv	Tip	Opis
`organization`	`string`	uid organizacije, da dobijete samo njene stavke (pogledajte `/organizations`).
`q`	`string`	Dio naziva, do 100 znakova.
`page`	`integer`	Stranica, počevši od 1. Zadano: 1.
`per_page`	`integer`	Broj stavki po stranici, od 1 do 100. Zadano: 50.

Polja svake stavke

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

400 invalid_parameter Neki parametar ima nevažeću vrijednost, npr. per_page iznad maksimuma.
404 organization_not_found Navedeni organization nije organizacija u kojoj korisnik može vidjeti ovu vrstu stavki.
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?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
  }
}