Перейти до вмісту

Помилки

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