Помилки
Помилка — це 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 |
Тимчасова помилка | Повторіть той самий запит пізніше |