Status Codes

A Just Serp API usa tanto códigos de status HTTP quanto um code de lógica de negócio na resposta JSON para indicar o resultado de uma requisição à API.

Tabela de Códigos de Status

Scenario	HTTP Status	Business Code	Credits Charged
Success	200	200	✅ Yes
Invalid Parameters	200	400	❌ No
Invalid API Key	401	401	❌ No
Insufficient Credits	200	402	❌ No
Resource Not Found	200	404	❌ No
Rate Limit Exceeded	200	429	❌ No
Internal Server Error	500	500	❌ No

Tratamento de Erros

Quando ocorre um erro, a API retorna um objeto JSON contendo o code de negócio e uma message para ajudar a diagnosticar o problema.

Exemplo de Resposta de Erro

{
  "code": 401,
  "message": "X-API-Key is missing. Please set X-API-Key header."
}

Recomendamos implementar lógica de retry para erros 500 com backoff exponencial.