Prvi koraci

API platforme

Pomoću API-ja vaši sistemi čitaju podatke o TV uređajima, datotekama i playlistama s vašeg računa bez otvaranja kontrolne ploče. Koristite ga da prikažete status TV uređaja u svom sistemu za monitoring, provjerite šta se prikazuje na svakom ekranu ili napravite izvještaje.

Svaki ključ vidi tačno ono što njegov korisnik vidi na kontrolnoj ploči: iste organizacije i, u svakoj od njih, ono što mu dozvole omogućavaju da pregleda.

Samo za čitanje

U ovoj verziji API samo čita podatke. Na vašem računu ništa se ne mijenja.

Isti pristup kao na kontrolnoj ploči

Dozvola uklonjena na kontrolnoj ploči odmah prestaje važiti i za API.

JSON preko HTTPS-a

Odgovori u JSON formatu i datumi u ISO 8601 s vremenskom zonom.

Format odgovora

Odgovori su u JSON formatu (UTF-8). Pojedinačna stavka stiže u data; liste sadrže i meta, s podacima o paginaciji.
Datumi su u formatu ISO 8601 s vremenskom zonom, npr. 2026-11-03T14:32:10-03:00.
Svaka stavka ima uid, isti kao na kontrolnoj ploči. Pomoću njega kasnije možete zatražiti tu stavku.
Polje bez vrijednosti stiže kao null. Nova polja mogu biti dodana u bilo kojem trenutku, pa zanemarite ona koja ne prepoznajete.

Počnite ovdje

1Autentifikacija: kreirajte ključ u Moj račun › API i šaljite ga u zaglavlju X-API-Key.
2Vaš korisnik: pošaljite prvi zahtjev da provjerite ključ.
3Šta koji korisnik vidi: pogledajte koje organizacije i stavke ključ može čitati.

Osnovna adresa

https://api.on-cloud.live/v1

Šta možete čitati

/mevaš korisnik i ključ koji se koristi
/organizationsorganizacije i dozvole
/tvsTV uređaji i njihov status
/filesučitane datoteke
/playlistsplayliste i njihove stavke

Prvi zahtjevcURLPHPJavaScript

curl "https://api.on-cloud.live/v1/me" \
  -H "X-API-Key: $API_KEY"

<?php
$ch = curl_init('https://api.on-cloud.live/v1/me');
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/me', {
  headers: { 'X-API-Key': process.env.API_KEY }
});
const { data } = await res.json();

Odgovor200

{
  "data": {
    "uid": "3c59dc048e8850243be8079a5c74d079",
    "name": "Mariana Souza",
    "email": "mariana@exemplo.com.br",
    "language": "pt_BR",
    "api_key": {
      "name": "Monitoramento",
      "prefix": "apk_527d541b",
      "created_at": "2026-11-01T09:15:42-03:00",
      "last_used_at": "2026-11-03T14:31:58-03:00"
    }
  }
}