Sustentação sistema Renach, Renavam, Renainf

Desenvolver um endpoint que permita aos órgãos autuadores consultar o status dos envios de fotos relacionados a autuações de trânsito. A consulta deve fornecer informações detalhadas sobre o processamento das imagens na base nacional, indicando sucesso, pendência ou eventual rejeição.

Endpoint:

Endpoint de Consulta:
Método: GET
URL: /api/consulta/status-fotos
Parâmetros da Consulta:

auto (Número da Autuação):
Tipo: String
Descrição: Número da autuação relacionada ao envio de fotos.
codigoInfracao (Código da Infração):
Tipo: String
Descrição: Código da infração associada ao envio de fotos.
codigoOrgaoAutuador (Código do Órgão Autuador):
Tipo: String
Descrição: Código identificador do órgão autuador responsável pela autuação.
Resposta da Consulta:

Quantidade de Fotos:
Tipo: Integer
Descrição: Número total de fotos associadas à autuação.
Status das Fotos:
Tipo: Array de Objetos
Descrição: Array contendo informações individuais sobre o status de cada foto.
Número da Foto:
Tipo: Integer
Descrição: Identificador único da foto.
Status:
Tipo: String
Descrição: Indicação do status da foto (processada com sucesso, pendente, rejeitada)

Requisitos Técnicos:

Autenticação:
A autenticação do órgão autuador deve ser realizada por meio de token de acesso.
Segurança:
A comunicação deve ser protegida por HTTPS.
Versionamento:
O endpoint deve suportar versionamento para garantir a compatibilidade com futuras atualizações.
Logs e Monitoramento:
Implementar registros detalhados de logs para rastreamento de consultas e monitoramento do sistema.
Tratamento de Erros:
Respostas apropriadas devem ser fornecidas em caso de erros, incluindo códigos de status HTTP específicos.

Exemplo de Uso: GET /api/consulta/status-fotos?auto=12345&codigoInfracao=5678&codigoOrgaoAutuador=901

Exemplo de Resposta: {
"quantidadeFotos": 3,
"statusFotos": [ {
"numeroFoto": 1,
"status": "Processada com Sucesso"
}, {
"numeroFoto": 2,
"status": "Pendente"
}, {
"numeroFoto": 3,
"status": "Rejeitada - Motivo: Dados Incorretos"
}
]
}