Requisitar arquivo

Solicita ao equipamento o envio de um arquivo de mídia. A resposta traz um requestId; quando o arquivo chegar aos nossos servidores, o seu Webhook recebe a URL via Data Push com o mesmo requestId. O status também pode ser acompanhado na plataforma YUV.

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: deviceImei, fileName e channel (1 a 9).

Jimi (JC400): envie em fileName o nome exato recebido na lista de arquivos (ex.: 2025_05_20_09_24_55_01.mp4). Pode enviar requestMemoryCard.

JTT (JC450, JC181, JC371, JC182): envie em fileName apenas o beginTime do arquivo desejado (ex.: 2025-05-20 07:42:30).

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": "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/download/request-file' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "deviceImei": "864993060000000", "fileName": "2025_05_20_09_24_55_01.mp4", "channel": 1, "requestMemoryCard": false }'

Revendedor x Cliente

Regras

Exemplo de lista de arquivos JTT recebida no Webhook

Erros específicos

Requisição

Respostas

Requisitar arquivo

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