Get details of a specific vehicle
GET/company/vehicles/:id
Recupera detalhes completos de um veículo específico da frota da empresa.
Objetivo
Permitir que as empresas visualizem informações completas sobre um único veículo, incluindo todos os metadados, referências de arquivos e capacidade de carga calculada.
Casos de Uso
- Visualizar detalhes completos do veículo antes da edição
- Exibir informações do veículo na visualização detalhada
- Recuperar URLs de imagens e do certificado de ITV
- Acessar intervalos de capacidade de carga calculados
Segurança
Este endpoint valida a propriedade - o veículo deve pertencer à empresa do usuário autenticado. Se o veículo existir, mas pertencer a outra empresa, retorna 403 CIA_NOT_OWNER.
URLs de Imagens
As URLs para imagens e certificados de ITV seguem o formato /images?file={s3_key}.
Acesse essas URLs com autenticação para recuperar os arquivos reais.
Campos Calculados
O campo cargo é calculado automaticamente com base no vehicle_type e contém
intervalos de capacidade de volume (m³) e peso (kg).
Request
Responses
- 200
- 400
- 401
- 403
- 404
Detalhes do veículo recuperados com sucesso.
Response Headers
Erro geral ao recuperar veículo
O usuário não possui uma empresa associada.
Proibido. O veículo existe, mas não pertence à empresa do usuário autenticado. Este é um erro de segurança que indica que o usuário está tentando acessar um recurso que não lhe pertence.
Veículo não encontrado.