Ошибки
Ошибки API Radist.Online: структура ответа с error_code, расшифровка кодов 1, 429 и 5xx, полный список ошибок для отладки запросов к API v2.
Общее
При ошибке обработки запросов API возвращает такую структуру:
| |
Описание некоторых ошибок
- Ошибка с кодом 1 означает, что формат запроса не соответствует тому, что метод ожидает. Формат описан в схеме запросов в swagger’e.
- Код 429 означает, что превышено ограничение на количество запросов в секунду. Замедлитесь. При превышении лимитов несколько раз подряд, вы будете временно заблокированы.
- Если получили код 5xx, сообщите в поддержку.
Список ошибок
| |
Часто задаваемые вопросы
Что означает ошибка 429 в API Radist.Online?
Превышено ограничение на количество запросов в секунду — нужно замедлиться. Если превысить лимиты несколько раз подряд, доступ временно заблокируют. В ответе эта ошибка приходит с именем TOO_MANY_REQUESTS, а сами лимиты на количество запросов в секунду описаны в общем разделе документации API.
Что делать при ошибке 500 или другой 5xx?
Сообщить в поддержку — именно это рекомендует документация. Коды 5xx относятся к обработке на нашей стороне, а не к формату запроса. В списке ошибок код 500 называется INTERNAL_SERVER_ERROR.
Что значит ошибка с кодом 1?
Формат запроса не соответствует тому, что ожидает метод: имя ошибки REQUEST_VALIDATION_ERROR. Сам формат описан в схеме запросов в swagger — сверьте тело запроса с ней. В ответе рядом с кодом приходит поле detail.
Что приходит в ответе, если запрос не прошёл?
Объект с четырьмя полями: error_code — числовой код, error_name — имя ошибки вроде REQUEST_VALIDATION_ERROR, message — короткое текстовое описание и detail с подробностями. Полный перечень кодов и имён есть на этой же странице в списке ошибок.
Что значат ошибки NOT_PAID и NOT_IN_SUBSCRIPTION?
Это коды 10 и 11. NOT_PAID означает, что подписка не оплачена, NOT_IN_SUBSCRIPTION — что подключение не входит в подписку. Оба относятся к состоянию подписки, а не к формату запроса, поэтому исправляются в личном кабинете, а не в коде.
Почему при создании контакта приходит CONTACT_PHONE_EMAIL_CONFLICT?
Контакт с таким же телефоном или почтой уже существует — это код 1001. Если контакт не находится по идентификатору, приходит CONTACT_NOT_FOUND с кодом 1000. Похожая логика у тегов: TAG_ALREADY_EXISTS означает, что тег с таким именем уже создан.
Что означает ошибка 413?
Тело запроса слишком большое — имя ошибки REQUEST_TOO_LARGE. Это код 413 из общего списка ошибок, рядом с 400 BAD_REQUEST, 404 NOT_FOUND и 429 TOO_MANY_REQUESTS.