Primii pași

API-ul platformei

Cu ajutorul API-ului, sistemele dumneavoastră pot consulta TV-urile, fișierele și playlisturile din contul dumneavoastră fără a deschide panoul de control. Folosiți-l pentru a afișa starea TV-urilor în sistemul de monitorizare, pentru a verifica ce rulează pe fiecare ecran sau pentru a crea rapoarte.

Fiecare cheie vede exact ce vede utilizatorul ei în panoul de control: aceleași organizații și, în fiecare organizație, ceea ce permisiunile acestuia îi permit să listeze.

Doar citire

În această versiune, API-ul doar consultă date. Nimic nu se modifică în contul dumneavoastră.

Același acces ca în panou

O permisiune retrasă în panoul de control se aplică imediat și în API.

JSON prin HTTPS

Răspunsuri în JSON și date calendaristice în format ISO 8601, cu fus orar.

Formatul răspunsurilor

Răspunsurile sunt în JSON (UTF-8). Un singur element vine în data; listele includ și meta, cu paginarea.
Datele calendaristice sunt în format ISO 8601, cu fusul orar, de exemplu 2026-11-03T14:32:10-03:00.
Fiecare element are un uid, același folosit în panoul de control. Folosiți-l pentru a consulta ulterior elementul.
Un câmp fără valoare vine ca null. Pot fi adăugate câmpuri noi oricând, așa că ignorați câmpurile pe care nu le cunoașteți.

Începeți de aici

1Autentificare: generați o cheie în Contul meu › API și trimiteți-o în antetul X-API-Key.
2Utilizatorul dumneavoastră: faceți prima cerere pentru a testa cheia.
3Ce poate vedea fiecare utilizator: vedeți ce organizații și elemente poate consulta cheia.

URL de bază

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

Ce puteți consulta

/meutilizatorul dumneavoastră și cheia folosită
/organizationsorganizații și permisiuni
/tvsTV-uri și starea lor
/filesfișiere încărcate
/playlistsplaylisturi și elementele lor

Prima cererecURLPHPJavaScript

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

Răspuns200

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