Códigos de Status

A Just Serp API usa códigos de status HTTP e um code de negócio na resposta JSON para indicar o resultado de uma solicitação à API.

Tabela de Códigos de Status

Cenário	Status HTTP	Código de Negócio	Créditos Cobrados
Sucesso	200	200	✅ Sim
Parâmetros Inválidos	200	400	❌ Não
Chave API Inválida	401	401	❌ Não
Créditos Insuficientes	200	402	❌ Não
Recurso Não Encontrado	200	404	❌ Não
Limite de Taxa Excedido	200	429	❌ Não
Erro Interno do Servidor	500	500	❌ Não

Tratamento de Erros

Quando ocorre um erro, a API retorna um objeto JSON com o code de negócio e uma message para ajudar no diagnóstico.

Exemplo de Resposta de Erro

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

Recomendamos implementar lógica de repetição para erros 500 com backoff exponencial.