Kom godt i gang

Platformens API

Med API'et kan dine systemer hente TV'erne, filerne og playlisterne på din konto uden at åbne kontrolpanelet. Brug det til at vise TV'ernes status i din egen overvågning, tjekke, hvad der vises på hver skærm, eller lave rapporter.

Hver nøgle ser præcis det samme, som dens bruger ser i kontrolpanelet: de samme organisationer og i hver organisation det, som brugerens tilladelser giver lov til at vise.

Kun læsning

I denne version kan API'et kun hente data. Intet på din konto bliver ændret.

Samme adgang som i kontrolpanelet

En tilladelse, der fjernes i kontrolpanelet, gælder med det samme også for API'et.

JSON over HTTPS

Svar i JSON og datoer i ISO 8601 med tidszone.

Svarformat

Svarene er i JSON (UTF-8). Et enkelt element ligger i data; lister indeholder også meta med sideinddelingen.
Datoer er i ISO 8601 med tidszone, f.eks. 2026-11-03T14:32:10-03:00.
Hvert element har et uid, det samme som bruges i kontrolpanelet. Brug det til at hente elementet senere.
Et felt uden værdi returneres som null. Der kan til enhver tid komme nye felter, så ignorer dem, du ikke kender.

Start her

1Godkendelse: Generér en nøgle under Min konto › API, og send den i headeren X-API-Key.
2Din bruger: Send din første forespørgsel for at teste nøglen.
3Hvad hver bruger kan se: Se, hvilke organisationer og elementer nøglen kan hente.

Basis-URL

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

Det kan du hente

/medin bruger og den aktuelle nøgle
/organizationsorganisationer og tilladelser
/tvsTV'er og deres status
/filesuploadede filer
/playlistsplaylister og deres elementer

Første forespørgselcURLPHPJavaScript

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

Svar200

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