1. Equipamentos
Yuv Cloud Services
prod
  • prod
  • quality
  • Introdução
  • Referências
  • API (Revendedor)
    • Alarmes
      • Obter Alarmes
    • Ativos
      • Obter lista
      • Visualizar
      • Cadastrar
      • Editar
      • Vincular/Desvincular equipamento
      • Deletar
    • Equipamentos
      • Abrir streaming
        POST
      • Obter lista
        GET
      • Visualizar
        GET
      • Cadastrar
        POST
      • Editar
        PUT
      • Deletar
        DELETE
      • Enviar comando
        POST
    • Clientes
      • Obter lista
      • Editar
      • Obter token
      • Cadastrar token
      • Cadastrar
      • Deletar
      • Deletar token
    • Downloads
      • Requisitar lista de arquivos
      • Requisitar arquivo
    • Playback
      • Streaming
    • Motoristas
      • Obter lista
      • Cadastrar
    • Ocorrências
      • Obter lista
      • Tratativa
    • Grupo de Permissão
      • Obter lista
    • GPS
      • Obter GPS
      • Obter Deslocamento
  • API (Cliente)
    • Controle de Acesso
    • Alarmes
      • Obter Alarmes
    • Equipamentos
      • Obter lista
      • Abrir streaming
    • Motoristas
      • Obter lista
      • Cadastrar
    • Ocorrências
      • Tratativa
      • Obter lista
    • GPS
      • Obter GPS
      • Obter Deslocamento
  1. Equipamentos

Abrir streaming

POST
/device/open-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 Revendedor.

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

Erros específicos#

Quando o IMEI não pertence ao seu escopo (ou o equipamento não tem ativo vinculado), a API responde 500 com {"error": "Dispositivo <IMEI> não encontrado"} / "Ativo do dispositivo <IMEI> não encontrado".

Requisição

Authorization
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200Sucesso
application/json
Bodyapplication/json

🟠400Bad request
🟠403Forbidden
🟠404Registry not found
🔴500Internal server error
🟠429Too Many Request
Request Request Example
Shell
JavaScript
Java
Swift
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
}'
Response Response Example
200 - Sucesso
{
    "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"
}
Modificado em 2026-10-02 19:54:03
Página anterior
Deletar
Próxima página
Obter lista
Built with