Začíname

API platformy

Vďaka API môžu vaše systémy načítať TV, súbory a playlisty z vášho účtu bez otvárania ovládacieho panela. Môžete tak zobrazovať stav TV vo svojom monitoringu, kontrolovať, čo sa prehráva na jednotlivých obrazovkách, alebo zostavovať prehľady.

Každý kľúč vidí presne to, čo jeho používateľ v ovládacom paneli: tie isté organizácie a v každej z nich to, čo mu jeho oprávnenia dovoľujú zobraziť.

Iba na čítanie

V tejto verzii API údaje iba načítava. Vo vašom účte sa nič nemení.

Rovnaký prístup ako v ovládacom paneli

Oprávnenie odobraté v ovládacom paneli platí pre API okamžite.

JSON cez HTTPS

Odpovede v JSON, dátum a čas vo formáte ISO 8601 s časovým pásmom.

Formát odpovedí

Odpovede sú vo formáte JSON (UTF-8). Jednotlivá položka prichádza v data; zoznamy navyše obsahujú meta s informáciami o stránkovaní.
Dátum a čas sú vo formáte ISO 8601 s časovým pásmom, napríklad 2026-11-03T14:32:10-03:00.
Každá položka má uid, rovnaký ako v ovládacom paneli. Pomocou neho môžete položku neskôr načítať.
Pole bez hodnoty má hodnotu null. Nové polia môžu pribudnúť kedykoľvek, preto tie, ktoré nepoznáte, ignorujte.

Začnite tu

1Overovanie: vygenerujte kľúč v časti Môj účet › API a posielajte ho v hlavičke X-API-Key.
2Váš používateľ: odošlite prvú požiadavku a otestujte kľúč.
3Čo vidia jednotliví používatelia: zistite, ktoré organizácie a položky môže kľúč načítať.

Základná adresa

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

Čo možno načítať

/meváš používateľ a použitý kľúč
/organizationsorganizácie a oprávnenia
/tvsTV a ich stav
/filesnahrané súbory
/playlistsplaylisty a ich položky

Prvá požiadavkacURLPHPJavaScript

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

Odpoveď200

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