Πρώτα βήματα

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Τι βλέπει κάθε χρήστης: δείτε ποιους οργανισμούς και ποια στοιχεία μπορεί να ανακτήσει το κλειδί.

Βασική διεύθυνση URL

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