Први кораци

API платформе

Помоћу API-ја ваши системи читају податке о ТВ уређајима, датотекама и плејлистама са вашег налога без отварања контролне табле. Користите га да прикажете статус ТВ уређаја у свом систему за мониторинг, проверите шта се приказује на сваком екрану или направите извештаје.

Сваки кључ види тачно оно што његов корисник види на контролној табли: исте организације и, у свакој од њих, оно што му дозволе омогућавају да прегледа.

Само за читање

У овој верзији API само чита податке. На вашем налогу се ништа не мења.

Исти приступ као на контролној табли

Дозвола уклоњена на контролној табли одмах престаје да важи и за API.

JSON преко HTTPS-а

Одговори у JSON формату и датуми у ISO 8601 са временском зоном.

Формат одговора

Одговори су у JSON формату (UTF-8). Појединачна ставка стиже у data; листе садрже и meta, са подацима о пагинацији.
Датуми су у формату ISO 8601 са временском зоном, нпр. 2026-11-03T14:32:10-03:00.
Свака ставка има uid, исти као на контролној табли. Помоћу њега касније можете да затражите ту ставку.
Поље без вредности стиже као null. Нова поља могу бити додата у било ком тренутку, па занемарите она која не препознајете.

Почните овде

1Аутентификација: направите кључ у Мој налог › API и шаљите га у заглављу X-API-Key.
2Ваш корисник: пошаљите први захтев да бисте проверили кључ.
3Шта који корисник види: погледајте које организације и ставке кључ може да чита.

Основна адреса

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

Шта можете да читате

/meваш корисник и кључ који се користи
/organizationsорганизације и дозволе
/tvsТВ уређаји и њихов статус
/filesотпремљене датотеке
/playlistsплејлисте и њихове ставке

Први захтевcURLPHPJavaScript

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

Одговор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"
    }
  }
}