Requisitar lista de arquivos

Solicita ao equipamento a lista de arquivos de mídia gravados em um dia. A resposta traz um requestId; quando o equipamento enviar a lista, ela chega ao seu Webhook via Data Push com o mesmo requestId.

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

date no formato AAAA-MM-DD. Se omitido, usa a data de hoje.

channel (1 a 9) é opcional: omita para trazer todos os canais. O valor 0 não é aceito.

requestMemoryCard (Jimi/JC400): true busca no cartão de memória.

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-list' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "deviceImei": "864993060000000", "date": "2025-05-20", "channel": 1, "requestMemoryCard": false }'

Revendedor x Cliente

Regras

Erros específicos

Requisição

Respostas

Requisitar lista de arquivos

Revendedor x Cliente#

Regras#

Erros específicos#

Requisição

Respostas

Revendedor x Cliente

Regras

Erros específicos