Обработка ошибок
Активация кодов включает несколько шагов, поэтому по пути могут возникнуть различные ошибки. Этот гайд покрывает все возможные коды ошибок, с которыми вы можете столкнуться.
Ошибки активации
Эти ошибки могут возникнуть во время активации кода.
Когда происходит ошибка активации, вы получите статус код 503 и конкретную ошибку в поле errorCode.
NO_ACCOUNTS_AVAILABLE
Нет доступных аккаунтов для обработки активации. Попробуйте снова через несколько минут или обратитесь в поддержку.
NO_CODES_AVAILABLE
Вы запросили активацию из базы данных, но коды недоступны. Попросите администратора добавить больше кодов в базу данных.
LOGIN_FAILED
Не удалось войти в аккаунт Midasbuy. Это редко происходит, поскольку сервер автоматически повторяет активации при возникновении этой ошибки.
Подождите несколько минут и попробуйте снова. Если проблема сохраняется, обратитесь в поддержку.
CHARACTER_NOT_FOUND
Предоставленный вами ID игрока неверен. Это происходит, когда ID игрока неправильный, или иногда когда запрос поиска игрока не удается.
INVALID_ACTIVATION_RESPONSE
Запрос активации был отправлен успешно, но Midasbuy вернул неожиданный ответ. Это редко и обычно означает, что Midasbuy не работает или они изменили формат ответа. Обратитесь в поддержку, если видите это часто.
CODE_USED
Этот код уже был активирован. Попробуйте другой код.
INVALID_CODE
Формат кода неверен. Проверьте на лишние пробелы или опечатки в коде.
RISK_CONTROL
Midasbuy заблокировал активацию для этого игрока. Обычно это происходит, когда слишком много кодов активируется слишком быстро для одного игрока. Подождите несколько минут перед повторной попыткой.
UNKNOWN
Произошла неизвестная ошибка. Вручную проверьте, был ли код активирован, и обратитесь в поддержку.
NETWORK_ERROR
Во время активации произошла сетевая ошибка на нашей стороне. Проверьте, был ли код активирован, и попробуйте позже.
Другие ошибки API
Другие эндпоинты используют стандартные HTTP статус коды для ошибок.
Например, GET /character возвращает 404, когда игрок не найден.
Проверьте справочник API для деталей об ошибках каждого эндпоинта.
Сетевые ошибки
Помните, что отсутствие ответа не означает, что ваш запрос не достиг сервера. Обрабатывайте сетевые ошибки так же, как и другие ошибки.
Обязательно устанавливайте достаточно большой таймаут для запросов к нашему сервису. Обычно активации выполняются очень быстро, но в некоторых редких случаях требуется больше времени.
Не повторяйте запросы слишком быстро - это создает ненужную нагрузку на сервер и может вызвать ограничения скорости.
Неверные запросы
Когда вы отправляете неверный запрос, API возвращает ошибку 415/422.
Ответ может выглядеть примерно так: