Доступ і формати
Базовий URL
Section titled “Базовий URL”https://suly.gg/api/partner/v1Кожен запит містить заголовок:
Authorization: Bearer suly_…- Ключ має вигляд
suly_і ще 43 символи (разом 48). - Ви створюєте його на сторінці офера в кабінеті замовника, у блоці Ключ API, коли офер схвалено. Кожен офер має власний ключ.
- Він показується лише один раз. Замінити ключ випускає новий ключ, а старий одразу перестає працювати (
401). - Тримайте його в таємниці: зберігайте у змінній середовища або у сховищі секретів і ніколи — у коді, логах чи браузері.
Запити й відповіді
Section titled “Запити й відповіді”- JSON на вході й на виході. Кожен
POSTнадсилаєContent-Type: application/json. - Невідомі поля й невідомі параметри запиту відхиляються з
400 INVALID_INPUT. - Час указується у форматі ISO 8601 в UTC:
2026-11-03T10:00:00.000Z.
Гроші — це рядок у доларах США з крапкою і щонайбільше шістьма знаками після неї: "12.5", "0.01". У відповідях завжди шість знаків: "12.500000". Ніколи не надсилайте гроші числом JSON.
Посторінкова видача
Section titled “Посторінкова видача”Списки повертають по 50 елементів на сторінку, спершу нові:
{ "participants": [], "total": 0, "page": 1, "pageSize": 50 }Наступну сторінку запитуйте через ?page=2.
Ліміти
Section titled “Ліміти”Для будь-якої інтеграції достатньо послідовних запитів. Якщо ви отримали 429 або 503, зачекайте й повторіть запит пізніше.