Справочник кодов ошибок

Отдельная страница глобальных и модульных кодов ошибок.

← Назад к документации

Пространства имён кодов модулей

Подкоды сгруппированы по модулям для быстрой диагностики.

ДиапазонМодульНазначение
40001-40111, 40401-40402, 50011АутентификацияВход/регистрация, капча/код по email, сброс/смена пароля.
40101-40301, 42901-42903, 50201, 50301ШлюзАутентификация API-ключа, проверка баланса, лимиты, ошибки провайдера.
40021-40028, 40302, 40411, 50021-50023ОплатаСоздание заказа, проверка статуса, отмена подписки.

Коды ошибок

КодНазваниеОписаниеРекомендация
200УспехЗапрос успешно обработан.Используйте `data` для полезной нагрузки.
400Неверный запросНеверные параметры или ошибка валидации.Проверьте обязательные поля, диапазоны и формат запроса.
401Не авторизованОшибка аутентификации (требуется вход, отсутствует/неверный API-ключ).Войдите снова или укажите корректный X-API-Key.
402Недостаточно средствНедостаточно баланса или квоты для запроса.Пополните счёт или повысьте план и повторите.
403Доступ запрещёнНет прав или аккаунт ограничен.Проверьте статус аккаунта и права доступа.
404Не найденоЗапрашиваемый ресурс не существует.Проверьте ID/номера заказов и наличие данных.
429Превышен лимит запросовПревышена частота запросов (в секунду/час/месяц).Повторите с задержкой или снизьте частоту.
500Внутренняя ошибка сервераОшибка обработки на сервере.Повторите позже; при повторении обратитесь в поддержку.
502Сервис временно недоступенЗапрос к сервису не удалось обработать.Повторите позже.
503Сервис перегруженСистема перегружена или сработал глобальный лимит.Повторите через некоторое время.

Шлюз Детальные подкоды

КодНазваниеОписаниеРекомендация
40101Сессия не авторизованаСессия входа отсутствует или недействительна.Войдите снова.
40102API-ключ отсутствуетAPI-ключ не указан.Укажите заголовок X-API-Key или bearer token.
40103API-ключ недействителенAPI-ключ недействителен.Используйте корректный API-ключ.
40201Недостаточно средствНедостаточно баланса или квоты.Пополните счёт или повысьте план.
40301Аккаунт замороженАккаунт заморожен или ограничен.Обратитесь в поддержку для восстановления.
42901Превышен лимит в секундуПревышен лимит запросов в секунду.Снизьте частоту и повторите с задержкой.
42902Превышен лимит в часПревышен лимит запросов в час.Снизьте частоту запросов.
42903Превышена месячная квотаДостигнута месячная квота вызовов.Повысьте план или дождитесь нового цикла.
50201Сервис временно недоступенЗапрос к сервису не удалось обработать.Повторите позже.
50301Сработал глобальный лимитСработала глобальная защита.Повторите через некоторое время.

Аутентификация Детальные подкоды

КодНазваниеОписаниеРекомендация
40001Неверная капчаКапча недействительна.Обновите капчу и повторите.
40002Требуется капчаДля операции требуется капча.Введите значение капчи.
40003Email уже зарегистрированЭтот email уже зарегистрирован.Войдите или сбросьте пароль.
40004Код по email недействителенКод подтверждения неверен или истёк.Запросите новый код.
40005Пароль слишком короткийДлина пароля меньше минимальной.Минимум 6 символов.
40006Токен недействителенТокен сброса недействителен или истёк.Запросите новый токен.
40007Неверный тип планаТип или название плана неверны.Используйте план из /myapi/plans.
40008Слишком частые запросы кодаКод запрашивался слишком часто.Подождите и повторите.
40111Неверный парольОшибка проверки email/пароля.Проверьте данные и повторите.
40401Email не найденEmail не зарегистрирован.Проверьте email или зарегистрируйтесь.
40402Пользователь не найденЗапись пользователя не существует.Проверьте состояние входа и ID.
50011Ошибка отправки emailНе удалось отправить письмо с кодом.Повторите позже.

Оплата Детальные подкоды

КодНазваниеОписаниеРекомендация
40021Заказ истёкЗаказ истёк до оплаты.Создайте новый заказ.
40022Заказ не в ожиданииЗаказ не в статусе ожидания.Проверьте статус перед оплатой.
40023Подписка только по картеПодписка поддерживает только оплату картой.Используйте метод credit_card.
40024Способ оплаты не поддерживаетсяВыбранный способ оплаты не поддерживается.Выберите поддерживаемый способ.
40025Отмена только оплаченной подпискиОтменить можно только оплаченную подписку.Отменяйте только оплаченные подписки.
40026Не подпискаТекущий заказ не является подпиской.Проверьте тип заказа перед отменой.
40027Отмена только StripeОтмена поддерживается только для подписок Stripe.Используйте заказы Stripe для этого эндпоинта.
40028Отсутствует ID подпискиДля заказа отсутствует ID подписки.Дождитесь синхронизации или повторите позже.
40302Доступ к ресурсу запрещёнРесурс не принадлежит вам.Используйте ресурсы своего аккаунта.
40411Заказ не найденЗапись заказа не существует.Проверьте значение order_no.
50021Ошибка создания оплатыНе удалось создать сессию оплаты.Повторите позже или выберите другой способ.
50022Отмена не поддерживаетсяТекущий провайдер не поддерживает отмену.Используйте поддерживаемого провайдера или поддержку.
50023Ошибка отмены подпискиНе удалось отменить подписку.Повторите позже; при повторении — в поддержку.