Tudo o que acontece vira um evento. Nada vira uma edição.
É a diferença entre um cadastro, que guarda o estado atual, e um registro, que guarda o que aconteceu. A primeira coisa pode ser corrigida em silêncio; a segunda, não.
Do acontecimento à consulta
- 01Algo acontece
Uma ordem de serviço é concluída, um laudo é emitido, uma transferência é registrada.
- 02Vira evento
Com data, origem, evidência anexa e um nível de confiabilidade — nunca uma edição do que já existia.
- 03Entra na história
O evento passa a fazer parte da linha do tempo daquele veículo, permanentemente.
- 04Notifica quem assina
Um webhook avisa os sistemas interessados. Quem consulta depois lê a história inteira.
Quatro compromissos
OpenAPI com versão explícita. Uma mudança que quebre integração é uma versão nova, não uma surpresa numa terça-feira.
Assinatura por tipo de evento, com reentrega em caso de falha e verificação de assinatura.
Nada é editado, nada é apagado. Corrigir é registrar um evento novo — é isso que transforma histórico em prova.
Toda leitura e toda escrita registradas, com o responsável. Requisito de LGPD e de perícia.
A documentação vem com o acesso
A API é fechada por credencial e o escopo é acordado por contrato — porque o que trafega é histórico de veículo, com dado pessoal envolvido. Fale com a gente e receba a especificação.
Integrar é entrar na rede.
Quem publica evento fortalece a história dos veículos que atende. Quem consulta decide melhor.