Ошибки
При запросе к API конструктора Quescha вы можете получить HTTP-статусы ошибок. Ниже — расшифровка и рекомендации по их обработке.
Коды ошибок
| Код | Причина | Что проверить |
|---|---|---|
401 | Ошибка авторизации | Передан ли заголовок Authorization со значением вашего API-ключа. Подробнее — на странице Авторизация. |
422 | Ошибка в параметре | Переданы ли все обязательные параметры метода. Сверьтесь со схемой запроса для конкретного метода. |
429 | Превышена частота запросов | Сделайте паузу между вызовами и реализуйте экспоненциальный backoff. |
409 | Запрет сервера | Возможная причина — превышен лимит ресурса (например, количество товаров в каталоге). |
Стратегия обработки в боте
В сценариях действий после вызова метода API сохраняйте JSON-ответ и HTTP-статус в переменные — это позволит ветвить логику по коду ошибки и показывать пользователю осмысленное сообщение вместо общей «что-то пошло не так».
Защита от 429
Не запускайте API-вызовы в цикле без задержек. Для массовых операций используйте встроенные массовые операции и Списки — они оптимизированы под пакетную обработку.