Referans · TV yo

Lis TV yo

GET /v1/tvs

Bay lis TV ki aktive yo nan òganizasyon kote itilizatè a ka wè TV, nan lòd alfabetik.

Repons divize an paj: eleman yo vini nan data, epi enfòmasyon sou paj la vini nan meta. Paginasyon ak filtè

Paramèt

Non	Tip	Deskripsyon
`organization`	`string`	uid yon òganizasyon, pou jwenn sèlman eleman pa l yo (gade `/organizations`).
`q`	`string`	Yon pati nan non an, jiska 100 karaktè.
`page`	`integer`	Paj, apati 1. Pa defo: 1.
`per_page`	`integer`	Kantite eleman pa paj, soti 1 rive 100. Pa defo: 50.

Chan chak eleman

uid string: Idantifyan TV a, menm sa yo itilize nan panèl la.
name string: Non TV a.
description string: Deskripsyon TV a (li ka vid).
organization object: Òganizasyon TV a: uid ak name.
playlist object | null: Playlist TV a (uid ak name), oswa null si li pa genyen.
status string: online, alert oswa offline, jan sa eksplike pi ba a.
last_seen_at string | null: Dènye kontak TV a ak platfòm nan, oswa null si li pa janm konekte.
activated_at string | null: Ki lè yo te aktive TV a.
app_version string: Vèsyon aplikasyon ki enstale sou TV a.
os string: Sistèm operasyon TV a, tankou android.
device object: Mak (brand) ak modèl (model) aparèy la, lè TV a bay enfòmasyon sa yo.
timezone string | null: Zòn lè TV a, tankou America/Sao_Paulo, oswa null.

Kijan yo kalkile estati a

online dènye kontak gen mwens pase 3 minit, li ap jwe
alert dènye kontak ant 3 ak 9 minit de sa, oswa TV a toujou ap demare
offline pa gen kontak depi 10 minit oswa plis, oswa li pa janm konekte

Se menm règ ak koulè estati yo nan panèl la.

Erè ki posib

400 invalid_parameter Yon paramèt gen yon valè ki pa valab, tankou per_page ki depase maksimòm nan.
404 organization_not_found organization yo bay la pa koresponn ak yon òganizasyon kote itilizatè a ka wè kalite eleman sa a.
Erè kle ak erè limit yo aplike pou tout endpoint yo. Wè tout erè yo

DemanncURLPHPJavaScript

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

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

Repons200

{
  "data": [
    {
      "uid": "d3d9446802a44259755d38e6d163e820",
      "name": "Caixa 2",
      "description": "",
      "organization": {
        "uid": "1679091c5a880faf6fb5e6087eb1b2dc",
        "name": "Loja Shopping Norte"
      },
      "playlist": null,
      "status": "offline",
      "last_seen_at": "2026-11-01T18:04:51-03:00",
      "activated_at": "2025-03-12T09:41:05-03:00",
      "app_version": "3.12.83",
      "os": "android",
      "device": {
        "brand": "Philco",
        "model": "PTV32G70"
      },
      "timezone": "America/Sao_Paulo"
    },
    {
      "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"
    }
  ],
  "meta": {
    "page": 1,
    "per_page": 2,
    "total": 3,
    "total_pages": 2
  }
}