Референца · ТВ уређаји

Подаци о ТВ уређају

GET /v1/tvs/{uid}

Приказује ТВ уређај са наведеним uid.

Параметар у путањи

Назив	Тип	Опис
`uid`	`string`	uid ТВ уређаја.

Поља одговора

uid string: Идентификатор ТВ уређаја, исти као на контролној табли.
name string: Назив ТВ уређаја.
description string: Опис ТВ уређаја (може бити празан).
organization object: Организација ТВ уређаја: uid и name.
playlist object | null: Плејлиста ТВ уређаја (uid и name) или null ако је нема.
status string: online, alert или offline, као што је објашњено испод.
last_seen_at string | null: Последњи контакт ТВ уређаја са платформом или null ако се никада није повезао.
activated_at string | null: Када је ТВ уређај активиран.
app_version string: Верзија апликације инсталиране на ТВ уређају.
os string: Оперативни систем ТВ уређаја, нпр. android.
device object: Марка (brand) и модел (model) уређаја, када их ТВ уређај пријави.
timezone string | null: Временска зона ТВ уређаја, нпр. America/Sao_Paulo, или null.

Како се израчунава статус

online контакт пре мање од 3 минута, репродукција је у току
alert контакт пре 3 до 9 минута или се ТВ уређај још покреће
offline нема контакта 10 минута или дуже или се никада није повезао

Исто правило важи за боје статуса на контролној табли.

Могуће грешке

404 not_found Ендпоинт не постоји, или ставка не постоји или припада организацији коју корисник не може да види.
Грешке у вези са кључем и ограничењем захтева важе за све ендпоинте. Погледај све грешке

ЗахтевcURLPHPJavaScript

curl "https://api.on-cloud.live/v1/tvs/c98cb8f9cc62887d1f6cf5693df9219c" \
  -H "X-API-Key: $API_KEY"

<?php
$ch = curl_init('https://api.on-cloud.live/v1/tvs/c98cb8f9cc62887d1f6cf5693df9219c');
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/tvs/c98cb8f9cc62887d1f6cf5693df9219c', {
  headers: { 'X-API-Key': process.env.API_KEY }
});
const { data } = await res.json();

Одговор200

{
  "data": {
    "uid": "c98cb8f9cc62887d1f6cf5693df9219c",
    "name": "Recepção",
    "description": "TV da entrada",
    "organization": {
      "uid": "8f14e45fceea167a5a36dedd4bea2543",
      "name": "Loja Centro"
    },
    "playlist": {
      "uid": "e4da3b7fbbce2345d7772b0674a318d5",
      "name": "Lista principal"
    },
    "status": "online",
    "last_seen_at": "2026-11-03T14:32:10-03:00",
    "activated_at": "2025-03-12T09:41:05-03:00",
    "app_version": "3.12.84",
    "os": "android",
    "device": {
      "brand": "TCL",
      "model": "43P635"
    },
    "timezone": "America/Sao_Paulo"
  }
}

Ставка не постоји или нема приступа404

{
  "error": {
    "code": "not_found",
    "message": "Item not found or you do not have access to it."
  }
}