Abrir streaming

Abre o canal de streaming ao vivo de uma câmera e retorna as URLs para consumo em players externos ou aplicações web (RTMP, HTTP-FLV e HLS). Compatível com equipamentos Jimi IoT, Streamax e HikVision.

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

📌 Esta é a versão da documentação para token de Cliente.

Revendedor x Cliente

Revendedor: qualquer equipamento do revendedor vinculado a um ativo.

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

Regras

channel aceita inteiros de 1 a 9. Na JC400, 1 = câmera interna (IN) e 2 = câmera externa (OUT); nos demais modelos o número é o próprio canal.

O equipamento precisa estar vinculado a um ativo.

Lista de canais por modelo: https://app.apidog.com/project/922569/apis/doc-1335233

São respeitados o limite de streamings simultâneos e o horário de privacidade configurados para o cliente.

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": "Erro no dispositivo: Dispositivo não encontrado"}; equipamento sem ativo vinculado → 500 com {"error": "Erro no ativo: Ativo não encontrado"}.

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/device/open-streaming' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "deviceImei": "864993060000000", "channel": 1 }'

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

Erros específicos

Requisição

Respostas

Abrir streaming

Revendedor x Cliente#

Regras#

Erros específicos#

Requisição

Respostas

Revendedor x Cliente

Regras

Erros específicos