Ошибки
Ошибка — это 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 |
Временная ошибка | Повторите тот же запрос позже |