Առաջին քայլեր

Հարթակի API

API-ի միջոցով ձեր համակարգերը կարող են կարդալ ձեր հաշվի հեռուստացույցները, ֆայլերը և փլեյլիստները՝ առանց կառավարման վահանակը բացելու։ Օգտագործեք այն՝ ձեր մոնիթորինգի համակարգում հեռուստացույցների կարգավիճակը ցուցադրելու, յուրաքանչյուր էկրանին ցուցադրվողը ստուգելու կամ հաշվետվություններ կազմելու համար։

Յուրաքանչյուր բանալի տեսնում է ճիշտ այն, ինչ տեսնում է դրա օգտատերը կառավարման վահանակում՝ նույն կազմակերպությունները, իսկ յուրաքանչյուր կազմակերպությունում՝ այն, ինչ նրա թույլտվությունները թույլ են տալիս ցուցակագրել։

Պատասխանների ձևաչափը

• Պատասխանները JSON-ով են (UTF-8)։ Մեկ տարրը գալիս է data դաշտում, իսկ ցանկերը ներառում են նաև meta դաշտը՝ էջավորման տվյալներով։
• Ամսաթվերը ISO 8601 ձևաչափով են՝ ժամային գոտիով, օրինակ՝ 2026-11-03T14:32:10-03:00։
• Յուրաքանչյուր տարր ունի uid, նույնը, ինչ օգտագործվում է կառավարման վահանակում։ Օգտագործեք այն՝ տարրը հետագայում ստանալու համար։
• Առանց արժեքի դաշտը գալիս է որպես null։ Նոր դաշտեր կարող են ավելացվել ցանկացած պահի, ուստի անտեսեք այն դաշտերը, որոնք չեք ճանաչում։

Սկսեք այստեղից

1. 1Նույնականացում: ստեղծեք բանալի Իմ հաշիվը › API բաժնում և ուղարկեք այն X-API-Key վերնագրով։
2. 2Ձեր օգտատերը: կատարեք առաջին հարցումը՝ բանալին ստուգելու համար։
3. 3Ինչ կարող է տեսնել յուրաքանչյուր օգտատեր: տեսեք, թե որ կազմակերպություններն ու տարրերը կարող է կարդալ բանալին։

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

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