Začínáme

API platformy

Díky API mohou vaše systémy načítat TV, soubory a playlisty z vašeho účtu bez otevírání ovládacího panelu. Můžete tak zobrazovat stav TV ve svém monitoringu, kontrolovat, co se přehrává na jednotlivých obrazovkách, nebo sestavovat přehledy.

Každý klíč vidí přesně to, co jeho uživatel v ovládacím panelu: stejné organizace a v každé z nich to, co mu jeho oprávnění dovolují zobrazit.

Jen pro čtení

V této verzi API data pouze načítá. Ve vašem účtu se nic nemění.

Stejný přístup jako v ovládacím panelu

Oprávnění odebrané v ovládacím panelu platí pro API okamžitě.

JSON přes HTTPS

Odpovědi v JSON, datum a čas ve formátu ISO 8601 s časovým pásmem.

Formát odpovědí

Odpovědi jsou ve formátu JSON (UTF-8). Jednotlivá položka přichází v data; výpisy navíc obsahují meta s informacemi o stránkování.
Datum a čas jsou ve formátu ISO 8601 s časovým pásmem, například 2026-11-03T14:32:10-03:00.
Každá položka má uid, stejný jako v ovládacím panelu. Pomocí něj můžete položku později načíst.
Pole bez hodnoty má hodnotu null. Nová pole mohou přibýt kdykoli, proto ta, která neznáte, ignorujte.

Začněte zde

1Ověřování: vygenerujte klíč v části Můj účet › API a posílejte ho v hlavičce X-API-Key.
2Váš uživatel: odešlete první požadavek a otestujte klíč.
3Co který uživatel vidí: zjistěte, které organizace a položky může klíč načítat.

Základní adresa

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

Co lze načítat

/meváš uživatel a použitý klíč
/organizationsorganizace a oprávnění
/tvsTV a jejich stav
/filesnahrané soubory
/playlistsplaylisty a jejich položky

První požadavekcURLPHPJavaScript

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

Odpověď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"
    }
  }
}