Yuv Cloud Services
  1. Downloads
Yuv Cloud Services
  • Introdução
  • API
    • Equipamentos
      • Enviar comando
      • Abrir streaming
    • Downloads
      • Requisitar lista de arquivos
        POST
      • Requisitar arquivo
        POST
  • Data Push
    • /pushFileDownloadRequest
    • JC400
      • /jc400/pushHeartbeat
      • /jc400/pushGps
      • /jc400/pushAlarm
      • /jc400/pushAlarmFile
      • /jc400/pushFileList
    • JC450
      • /jc450/pushHeartbeat
      • /jc450/pushGps
      • /jc450/pushAlarm
      • /jc450/pushAlarmFile
      • /jc450/pushFileList
    • JC181
      • /jc181/pushHeartbeat
      • /jc181/pushGps
      • /jc181/pushAlarm
      • /jc181/pushAlarmFile
      • /jc181/pushFileList
  1. Downloads

Requisitar arquivo

POST
/download/request-file
downloads
Após enviar a requisição de mídia, você receberá um requestId na resposta. Depois, quando o arquivo chegar em nossos servidores, seu Webhook receberá a URL do arquivo via Data Push, junto com o mesmo requestId para facilitar a identificação da requisição.
Também é possível acompanhar o status da requisição pela plataforma YUV.

JC400#

Para a JC400, os únicos campos obrigatórios são deviceImei e fileName.
No campo fileName, envie exatamente o nome do arquivo como recebido no seu Webhook via Data Push.

JC450 e JC181#

Para JC450 e JC181, os campos obrigatórios são: deviceImei, fileName e channel.
Ao receber a lista de arquivos no seu Webhook, o conteúdo será parecido com:
[{
  "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
},
{
  "alarmFlag": 0,
  "beginTime": "2025-05-20 07:42:30",
  "channel": 3,
  "codeType": 0,
  "endTime": "2025-05-20 07:45:30",
  "fileSize": 23741016,
  "resourceType": 2,
  "storageType": 0
}],
Para o campo fileName, use apenas o beginTime do arquivo desejado.
Exemplo: para solicitar o arquivo de 20/05/2025 07:42:30 a 07:45:30, o fileName deve ser 2025-05-20 07:42:30.
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location --request POST 'https://api.cloud-services.yuv.com.br/download/request-file' \
--header 'Content-Type: application/json' \
--data-raw '{
    "deviceImei": "12345678910",
    "fileName": "2025_05_20_09_24_55_01.mp4"
}'
Response Response Example
200 - Example 1
{
    "requestId": 869308
}

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/json
deviceImei
string 
requerido
IMEI do equipamento
fileName
string 
requerido
Arquivo desejado
channel
integer 
opcional
Canal da câmera - Somente para JC450 e JC181
Examples

Respostas

🟢200Success
application/json
Body
rqeuestId
integer 
requerido
ID da requisição
🟠400Bad request
🟠403Forbidden
🟠405Method not allowed
🔴500Internal server error
Modificado em 2025-05-20 16:34:42
Página anterior
Requisitar lista de arquivos
Próxima página
/pushFileDownloadRequest
Built with