Коды статусов
Just Serp API использует коды состояния HTTP и бизнес-код code в ответе JSON, чтобы обозначить результат запроса к API.
Таблица кодов состояния
| Сценарий | Статус HTTP | Бизнес-код | Списано кредитов |
|---|---|---|---|
| Успех | 200 | 200 | ✅ Да |
| Недопустимые параметры | 200 | 400 | ❌ Нет |
| Недействительный ключ API | 401 | 401 | ❌ Нет |
| Недостаточно кредитов | 200 | 402 | ❌ Нет |
| Ресурс не найден | 200 | 404 | ❌ Нет |
| Превышен лимит запросов | 200 | 429 | ❌ Нет |
| Внутренняя ошибка сервера | 500 | 500 | ❌ Нет |
Обработка ошибок
При возникновении ошибки API возвращает объект JSON, содержащий бизнес-code и message, чтобы помочь вам диагностировать проблему.
Пример ответа с ошибкой
json
{
"code": 401,
"message": "X-API-Key is missing. Please set X-API-Key header."
}Мы рекомендуем реализовать логику повторных попыток для ошибок 500 с экспоненциальной задержкой.