Status Codes

Just Serp API использует как HTTP-коды состояния, так и бизнес-логический code в JSON-ответе для указания результата запроса API.

Таблица кодов состояния

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

Обработка ошибок

При возникновении ошибки API возвращает JSON-объект, содержащий бизнес-code и message, чтобы помочь вам диагностировать проблему.

Пример ответа с ошибкой

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

Мы рекомендуем реализовать логику повторных попыток для ошибок 500 с экспоненциальной задержкой.