Это руководство по устранению неполадок, а не монитор доступности в реальном времени — страницы статуса с историей доступности пока не существует. У ошибок поиска, проблем консоли и вопросов оплаты ниже есть свой следующий шаг.
Читайте message и code в теле ответа, а не только HTTP-статус. Повторяйте 429, 500, 502 или 503 с задержкой; при любом другом статусе нужно исправить запрос или ключ, а не повторять его.
Зафиксируйте время и действие, которое завершилось ошибкой. При ошибке провайдера идентификации сначала попросите администратора вашей организации проверить настроенное подключение SSO.
Проверьте экран использования в консоли — он разбивает месячный счётчик на поиск, индексацию, ИИ и остальное. Владельцы получают письмо при достижении 80% и 100% квоты до того, как что-либо будет ограничено.
Сегодня опрашивать нечего — эта страница представляет собой статичное руководство по устранению неполадок. В соглашении об уровне обслуживания указаны черновые целевые показатели доступности, а не измеренное историческое обязательство.
401 / 403
Ключ отсутствует, неизвестен, истёк или не даёт доступа к этой операции, коллекции или источнику. Исправьте ключ — повтор не поможет.
402
Не прошёл платёж по подписке, либо владелец приостановил API. Каждая операция отвечает 402, пока это не будет улажено или возобновлено.
429
Посмотрите resets_at или Retry-After в ответе, чтобы понять, сколько ждать, — секунды для ограничения скорости, потенциально дни для месячной квоты.
500 / 502 / 503
Непредвиденная ошибка, либо поисковый движок был кратковременно недоступен. Повторяйте с задержкой — это единственные серверные ошибки, которые стоит повторять.
Полный справочник по кодам статуса, включая то, какие ошибки стоит повторять и как Idempotency-Key защищает повторную запись, — в справочнике об ошибках и повторах.
// Gateway and search-engine operations
{ "message": "Forbidden - this API key may not access the collection \"orders\"." }
// Control-plane operations (events, recommendations, experiments, ...)
{
"defined": false,
"code": "TOO_MANY_REQUESTS",
"status": 429,
"message": "Quota exceeded for this organization.",
"data": { "resets_at": 1790812800000 }
}Узнать больше
Лучший способ оценить поисковую платформу — не читать ещё одну сравнительную таблицу.
И только после этого принимайте решение.