Перейти к содержимому

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

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, подождите и повторите запрос позже.