1. Downloads
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
      • Obter lista
      • Abrir streaming
      • Visualizar
      • Cadastrar
      • Editar
      • Deletar
      • Enviar comando
    • Clientes
      • Obter lista
      • Editar
      • Obter token
      • Cadastrar token
      • Cadastrar
      • Deletar
      • Deletar token
    • Downloads
      • Requisitar lista de arquivos
        POST
      • Requisitar arquivo
        POST
    • 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. Downloads

Requisitar lista de arquivos

POST
/download/request-file-list
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#

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/download/request-file-list' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "deviceImei": "864993060000000",
    "date": "2025-05-20",
    "channel": 1,
    "requestMemoryCard": false
}'
Response Response Example
200 - Sucesso
{
    "requestId": 123456
}
Modificado em 2026-10-02 19:54:07
Página anterior
Deletar token
Próxima página
Requisitar arquivo
Built with