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

Доступ і формати

https://suly.gg/api/partner/v1

Кожен запит містить заголовок:

Authorization: Bearer suly_…
  • Ключ має вигляд suly_ і ще 43 символи (разом 48).
  • Ви створюєте його на сторінці офера в кабінеті замовника, у блоці Ключ API, коли офер схвалено. Кожен офер має власний ключ.
  • Він показується лише один раз. Замінити ключ випускає новий ключ, а старий одразу перестає працювати (401).
  • Тримайте його в таємниці: зберігайте у змінній середовища або у сховищі секретів і ніколи — у коді, логах чи браузері.
  • 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.

Списки повертають по 50 елементів на сторінку, спершу нові:

{ "participants": [], "total": 0, "page": 1, "pageSize": 50 }

Наступну сторінку запитуйте через ?page=2.

Для будь-якої інтеграції достатньо послідовних запитів. Якщо ви отримали 429 або 503, зачекайте й повторіть запит пізніше.