400 Bad Request
Parâmetros inválidos ou body inválido.
400 Bad Request
{
"success": false,
"error": {
"code": "BAD_REQUEST",
"message": "Parâmetros inválidos para esta operação."
}
}Documentação técnica
Erros
Trate respostas de erro com base em códigos HTTP e no payload padronizado da AutoDataAPI.
Formato padrão de erro
Error payload
{
"success": false,
"error": {
"code": "ERROR_CODE",
"message": "Mensagem descritiva do erro."
}
}Erros comuns
401 Unauthorized
API Key/Secret ausente ou credenciais inválidas.
401 Unauthorized
{
"success": false,
"error": {
"code": "UNAUTHORIZED",
"message": "Credenciais ausentes ou inválidas."
}
}403 Forbidden
Sem permissão, chave revogada ou assinatura sem acesso.
403 Forbidden
{
"success": false,
"error": {
"code": "FORBIDDEN",
"message": "Sua credencial não possui acesso a este recurso."
}
}404 Not Found
Recurso ou endpoint não encontrado.
404 Not Found
{
"success": false,
"error": {
"code": "NOT_FOUND",
"message": "Recurso solicitado não foi encontrado."
}
}409 Conflict
Conflito de criação/duplicidade, quando aplicável.
409 Conflict
{
"success": false,
"error": {
"code": "CONFLICT",
"message": "Conflito ao processar a solicitação."
}
}422 Unprocessable Entity
Regra de negócio inválida, quando aplicável.
422 Unprocessable Entity
{
"success": false,
"error": {
"code": "UNPROCESSABLE_ENTITY",
"message": "Regra de negócio não atendida."
}
}429 Too Many Requests
Quota excedida para o período.
429 Too Many Requests
{
"success": false,
"error": {
"code": "QUOTA_EXCEEDED",
"message": "Limite mensal de requisições excedido."
}
}500 Internal Server Error
Erro interno durante processamento.
500 Internal Server Error
{
"success": false,
"error": {
"code": "INTERNAL_ERROR",
"message": "Falha interna ao processar a solicitação."
}
}