Tratamento de Erros

Nossas APIs utilizam o padrão RFC 7807 (Problem Details for HTTP APIs) para fornecer informações ricas e consistentes sobre erros.

Estrutura do Erro

Quando ocorrer um erro, a API retornará um JSON com o Content-Type application/problem+json.

{
    "type": "https://api.redefrota.com.br/probs/validation-error",
    "title": "Erro de Validação",
    "status": 400,
    "detail": "O campo 'placa' é obrigatório e deve seguir o formato ABC-1234.",
    "instance": "/v1/carriers/vehicles"
}

Códigos HTTP Comuns

Lista de erros e descrições.

1. 400 Bad Request:A requisição é inválida (ex: JSON malformado ou validação falhou).

2. 401 Unauthorized:Falta autenticação ou a chave/token é inválida.

3. 403 Forbidden:Você está autenticado, mas não tem permissão para acessar este recurso.

4. 404 Not Found:O recurso solicitado não existe.

5. 429 Too Many Requests:Você excedeu o limite de requisições. Verifique o header Retry-After.

6. 500 Internal Server Error:Erro inesperado no servidor. Tente novamente mais tarde.