Перейти к содержимому

Ошибки

Ошибка — это HTTP-статус с телом в формате JSON:

{ "code": "INVALID_INPUT", "messageKey": "…", "retryable": false, "correlationId": "…" }
  • code стабилен: стройте свою логику на нём.
  • retryable: true означает, что тот же запрос можно отправить позже ещё раз.
  • Записывайте в лог code и correlationId (но никогда не ключ) и указывайте correlationId, когда пишете в поддержку.
Статус Код Когда Что делать
400 INVALID_INPUT Неверный запрос, поле или неизвестный параметр Исправьте запрос; не повторяйте его в том же виде
401 NOT_AUTHENTICATED Нет ключа, неверный ключ или ключ был заменён Остановитесь и проверьте ключ
403 FORBIDDEN Аккаунт заказчика заблокирован на suly.gg Остановитесь и свяжитесь с поддержкой
404 NOT_FOUND Такого участника в этом оффере нет, или адрес неизвестен Проверьте идентификатор и путь
409 OFFER_ENDED Оффер закрыт: коды и начисления больше не принимаются Остановите задачи; чтение по-прежнему работает
409 PARTICIPANT_NOT_ACTIVE Начисление автору без кода или автору, которому отказали Сначала отправьте код
409 CREATOR_BANNED Автор заблокирован на suly.gg Не платите
409 INSUFFICIENT_BUDGET Бюджет меньше суммы с комиссией Пополните бюджет оффера, затем повторите
409 EXTERNAL_ID_CONFLICT Этот externalId уже использован с другими данными Разберитесь; никогда не перезаписывайте
429 (лимит запросов) Слишком много запросов Повторите позже с паузой
503 DEPENDENCY_UNAVAILABLE Временная ошибка Повторите тот же запрос позже