Hapat e parë

API-ja e platformës

Me API-n, sistemet tuaja mund të lexojnë televizorët, skedarët dhe listat e luajtjes në llogarinë tuaj pa hapur panelin e kontrollit. Përdoreni për të shfaqur statusin e televizorëve në sistemin tuaj të monitorimit, për të kontrolluar se çfarë po luhet në secilin ekran ose për të përgatitur raporte.

Çdo çelës sheh saktësisht atë që sheh përdoruesi i tij në panelin e kontrollit: të njëjtat organizata dhe, në secilën organizatë, atë që lejet e këtij përdoruesi i lejojnë të listojë.

Vetëm për lexim

Në këtë version, API-ja vetëm lexon të dhëna. Asgjë nuk ndryshohet në llogarinë tuaj.

E njëjta qasje si në panelin e kontrollit

Një leje e hequr në panelin e kontrollit vlen menjëherë edhe për API-n.

JSON përmes HTTPS

Përgjigje në JSON dhe data në ISO 8601 me zonën kohore.

Formati i përgjigjeve

Përgjigjet janë në JSON (UTF-8). Një element i vetëm vjen te data; listat përfshijnë edhe meta, me të dhënat e ndarjes në faqe.
Datat jepen në ISO 8601 me zonën kohore, si p.sh. 2026-11-03T14:32:10-03:00.
Çdo element ka një uid, të njëjtin që përdoret në panelin e kontrollit. Përdoreni për ta marrë elementin më vonë.
Një fushë pa vlerë vjen si null. Fusha të reja mund të shtohen në çdo kohë, prandaj shpërfillni ato që nuk i njihni.

Filloni këtu

1Vërtetimi: krijoni një çelës te Llogaria ime › API dhe dërgojeni në kokën X-API-Key.
2Përdoruesi juaj: bëni kërkesën e parë për të testuar çelësin.
3Çfarë mund të shohë secili përdorues: shihni cilat organizata dhe elemente mund të lexojë çelësi.

URL-ja bazë

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

Çfarë mund të lexoni

/mepërdoruesi juaj dhe çelësi në përdorim
/organizationsorganizatat dhe lejet
/tvstelevizorët dhe statusi i tyre
/filesskedarët e ngarkuar
/playlistslistat e luajtjes dhe elementet e tyre

Kërkesa e parë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();

Përgjigjja200

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