Yuv Cloud Services
  1. JC181
Yuv Cloud Services
  • Introdução
  • Referências
  • API
    • Equipamentos
      • Enviar comando
      • Abrir streaming
      • Obter lista
      • Visualizar
      • Cadastrar
      • Editar
      • Deletar
    • Downloads
      • Requisitar lista de arquivos
      • Requisitar arquivo
    • Playback
      • Streaming
    • Motoristas
      • Cadastrar
      • Obter lista
    • Ocorrências
      • Tratativa
    • Ativos
      • Obter lista
      • Visualizar
      • Cadastrar
      • Editar
      • Deletar
      • Vincular/Desvincular equipamento
    • Alarmes
      • Obter Alarmes
    • GPS
      • Obter GPS
      • Obter Deslocamento
    • Facial
      • Obter lista
      • Cadastrar faciais
      • Deletar imagens
      • Associar ao Equipamento
  • Data Push
    • /pushFileDownloadRequest
    • /occurrence
    • JC181
      • /jc181/pushHeartbeat
      • /jc181/pushGps
      • /jc181/pushAlarm
      • /jc181/pushAlarmFile
      • /jc181/pushFileList
    • JC371
      • /jc371/pushGps
      • /jc371/pushHeartbeat
      • /jc371/pushAlarm
      • /jc371/pushAlarmFile
      • /jc371/pushFileList
    • JC400
      • /jc400/pushHeartbeat
      • /jc400/pushGps
      • /jc400/pushAlarm
      • /jc400/pushAlarmFile
      • /jc400/pushFileList
    • JC450
      • /jc450/pushHeartbeat
      • /jc450/pushGps
      • /jc450/pushAlarm
      • /jc450/pushAlarmFile
      • /jc450/pushFileList
  1. JC181

/jc181/pushAlarm

http://your-webhook-endpoint.com/jc181/pushAlarm

Descrição#

O endpoint /jc181/pushAlarm contém informações de alarmes gerados pela JC181, podendo conter alarmes de ADAS ou DMS, dependendo do firmware e modelo da câmera.

AlarmLabel#

Todo alarme que pode possuir mídias, possui um campo alarmLabel. Esse campo é um identificador único daquele alarme. Quando você receber um arquivo no endpoint /jc181/pushAlarmFile, o nome do arquivo terá o seguinte formato:
12345678910111213_30313533313236250522105127000500_3_01.jpg
No arquivo acima, o alarmLabel é o 30313533313236250522105127000500.
Quando você recebe uma informação de alarme no endpoint /jc181/pushAlarm, o campo alarmLabel vem no seguinte formato:
30,31,35,33,31,32,36,25,05,22,10,51,27,00,05,00
Para vincular os arquivos ao alarme, basta você remover as vírgulas do campo alarmLabel e fazer a vinculação entre ambos.

Estrutura do Payload#

O payload é um array de objetos JSON, onde cada objeto contém um pacote de alarme de um equipamento, podendo existir N pacotes de diferentes equipamento.
CampoTipoDescrição
imeistringIMEI do dispositivo de rastreamento.
licensePlatestringPlaca do veículo associado ao evento.
latitudefloatCoordenada de latitude.
longitudefloatCoordenada de longitude.
speedintVelocidade do veículo no momento do evento (km/h).
gpsTimestringData e hora da captura do GPS no formato ISO 8601 (YYYY-MM-DDTHH:MM:SS.sssZ).
gateTimestringData e hora do evento no formato ISO 8601 (YYYY-MM-DDTHH:MM:SS.sssZ).
alarmTypeIdintCódigo identificador do tipo de alarme gerado.
alarmLabelstringIdentificador único do alarme
driverIdint | nullID do motorista associado ao alarme, se identificado.
driverNamestring | nullNome do motorista associado ao alarme, se identificado.

Descrição do campo alarmTypeId#

Você encontrará uma tabela relacionando cada alarmTypeId com sua descrição em: Referências de Alarmes

Exemplo de Envio#

[
    {
        "imei": "123456789101112",
        "licensePlate": "ABC1234",
        "latitude": -19.876813,
        "longitude": -43.402465,
        "speed": 31,
        "gpsTime": "2025-05-22T13:06:36.000Z",
        "gateTime": "2025-05-22T13:06:48.873Z",
        "alarmTypeId": 10,
        "alarmLabel": "30,32,35,35,39,37,30,25,05,22,10,06,36,00,05,00",
        "driverId": 42,
        "driverName": "João da Silva",
    }
]
Modificado em 2025-11-21 13:24:41
Página anterior
/jc181/pushGps
Próxima página
/jc181/pushAlarmFile
Built with