Доступ и форматы
Базовый URL
Заголовок раздела «Базовый URL»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, подождите и повторите запрос позже.