Streaming

Abre um canal de playback (reprodução de gravação) do equipamento e retorna as URLs para consumo. Use os arquivos recebidos no Webhook a partir de POST /download/request-file-list.

Disponível para: Revendedor e Cliente
Rate limit: 80 requisições/minuto (operação pesada)

Revendedor x Cliente

Revendedor: qualquer equipamento do revendedor vinculado a um ativo.

Cliente: apenas equipamentos de ativos do próprio cliente.

Regras

Obrigatórios para todos: deviceImei e channel (1 a 9).

Jimi (JC400): envie também filename com o nome exato do arquivo recebido no Webhook.

JTT (JC450, JC181, JC371, JC182): envie beginTime e endTime (AAAA-MM-DD hh:mm:ss) do trecho desejado.

Atenção ao nome dos campos: filename (minúsculo), beginTime e endTime (camelCase).

Exemplo de lista de arquivos JTT recebida no Webhook

[{
  "alarmFlag": 0,
  "beginTime": "2025-05-20 07:42:30",
  "channel": 2,
  "codeType": 0,
  "endTime": "2025-05-20 07:45:30",
  "fileSize": 24605816,
  "resourceType": 2,
  "storageType": 0
}]

Erros específicos

Equipamento indisponível (offline, canal que não abre, sem vídeo) → 409 com {"error": "<mensagem>"}, no idioma do usuário do token.

Falha interna ou de rede ao falar com o equipamento → 502 com {"error": {"source": "device", "code": 500 | 400, "message": "<mensagem>"}}.

O equipamento não respondeu a tempo → 504 com {"error": {"source": "device", "code": 600, "message": "<mensagem>"}}.

IMEI inexistente ou fora do seu escopo → 500 com {"error": "Dispositivo não encontrado"}; equipamento sem ativo vinculado → 422.

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

curl --location 'https://api.cloud-services.yuv.com.br/playback/open-streaming' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "deviceImei": "864993060000000", "channel": 1, "filename": "2026_05_15_11_05_06_01.ts" }'

{ "urlRtmp": "rtmp://live.iothub.yuv.com.br:1936/live/1234567890", "urlFlv": "https://live.iothub.yuv.com.br/live/1234567890.flv", "urlHls": "https://live.iothub.yuv.com.br/live/1234567890/hls.m3u8" }

Revendedor x Cliente

Regras

Exemplo de lista de arquivos JTT recebida no Webhook

Erros específicos

Requisição

Respostas

Streaming

Revendedor x Cliente#

Regras#

Exemplo de lista de arquivos JTT recebida no Webhook#

Erros específicos#

Requisição

Respostas

Revendedor x Cliente

Regras

Exemplo de lista de arquivos JTT recebida no Webhook

Erros específicos