Data e Hora
Esta seção trata da leitura e atualização da data e hora das antenas veiculares. A sincronização correta do relógio interno dos dispositivos é essencial para garantir registros precisos de eventos e comunicação entre sistemas. É possível interagir com as antenas de duas formas: através de instâncias de conexão temporária (quando a antena ainda não está cadastrada) ou por meio do ID da antena (quando ela já está registrada no sistema). Ambos os métodos permitem obter ou atualizar o timestamp do dispositivo.
1. Obter Data/Hora (por Instância)
Descrição:
Recupera a data e hora atual de uma antena conectada, utilizando a identificação da instância de conexão estabelecida. Esse método é ideal quando a comunicação foi feita por meio de uma descoberta de rede ou conexão temporária.
GET /api/v1/vehicleAntennas/instances/{id}/timestamps: Retorna a data e hora da antena a partir da instância de conexão.
Quando Usar:
Para verificar o relógio interno da antena durante testes.
Quando não há antena cadastrada, mas a conexão foi realizada com sucesso.
Obter data e hora da antena de tag veicular por Instância conectada
JWT Authorization header using the Bearer scheme.
Enter 'Bearer'[space] and then your token in the text input below.
Example: "Bearer 12345abcdef"
Id da Instância conectada
Nome da cultura específica usada para definir os formatos de dados (pt-BR, en-US)
en-USQuando a obtenção da data/hora ocorrer com sucesso
Quando ocorrer erro
2. Atualizar Data/Hora (por Instância)
Descrição:
Atualiza o relógio interno da antena conectada utilizando a instância gerada após a conexão via IP. Esse comando sincroniza a hora do dispositivo com a do servidor ou do sistema integrador.
POST /api/v1/vehicleAntennas/instances/{id}/timestamps: Envia a data e hora atual para a antena, com base em uma conexão via instância.
Quando Usar:
Ao configurar uma nova antena descoberta na rede.
Para corrigir o relógio de uma antena em comunicação temporária.
Atualizar a data/hora da antena de tag veicular por Instância conectada
JWT Authorization header using the Bearer scheme.
Enter 'Bearer'[space] and then your token in the text input below.
Example: "Bearer 12345abcdef"
Id da instância conectada
Nome da cultura específica usada para definir os formatos de dados (pt-BR, en-US)
en-USQuando a data/hora for atualizada com sucesso
Quando ocorrer erro
3. Obter Data/Hora (por ID)
Descrição:
Recupera a data e hora atual da antena cadastrada no sistema, identificada por seu id. Ideal para ambientes com dispositivos fixos e integrados ao controle central.
GET /api/v1/vehicleAntennas/{id}/timestamps: Retorna a data e hora da antena cadastrada no sistema.
Quando Usar:
Para verificação rotineira do horário das antenas.
Para auditoria ou diagnóstico.
Obter data e hora da antena de tag veicular
JWT Authorization header using the Bearer scheme.
Enter 'Bearer'[space] and then your token in the text input below.
Example: "Bearer 12345abcdef"
Id da Antena
Nome da cultura específica usada para definir os formatos de dados (pt-BR, en-US)
en-USQuando a obtenção da data/hora ocorrer com sucesso
Quando ocorrer erro
4. Atualizar Data/Hora (por ID)
Descrição:
Atualiza a data e hora de uma antena previamente cadastrada, garantindo a sincronia entre o dispositivo e o sistema. A operação é feita diretamente pelo id da antena.
POST /api/v1/vehicleAntennas/{id}/timestamps: Atualiza o relógio interno da antena cadastrada no sistema.
Quando Usar:
Durante manutenção preventiva ou corretiva.
Para sincronização periódica do relógio das antenas.
Sempre que a hora for um fator crítico para marcações e registros.
Atualizar a data/hora da antena de tag veicular
JWT Authorization header using the Bearer scheme.
Enter 'Bearer'[space] and then your token in the text input below.
Example: "Bearer 12345abcdef"
Id da antena de tag veicular
Nome da cultura específica usada para definir os formatos de dados (pt-BR, en-US)
en-USQuando a data/hora for atualizada com sucesso
Quando ocorrer erro
Atualizado