Участники
Участник — это автор, который присоединился к вашему офферу.
| Статус | Что означает |
|---|---|
pending |
Присоединился и ждёт от вас код |
active |
У него есть код и ссылка; может получать начисления |
rejected |
Вы ему отказали; автор видит вашу причину |
GET /participants
Заголовок раздела «GET /participants»curl -s "https://suly.gg/api/partner/v1/participants?status=pending&page=1" \ -H "Authorization: Bearer $SULY_KEY"status принимает значения pending, active, rejected или all (по умолчанию). По 50 на страницу, сначала новые.
{ "participants": [ { "participantId": "…", "status": "pending", "creator": { "userId": "…", "name": "Andry" }, "channels": [ { "platform": "youtube", "name": "Andry Plays", "handle": "UC…", "url": "https://www.youtube.com/channel/UC…", "views": 120000, "periodDays": 28, "countries": [{ "country": "RU", "share": 41.5 }] } ], "code": null, "link": null, "rejectReason": null, "info": null, "joinedAt": "2026-11-03T10:00:00.000Z", "updatedAt": "2026-11-03T10:00:00.000Z", "accrued": "0.000000" } ], "total": 1, "page": 1, "pageSize": 50}| Поле | Что означает |
|---|---|
participantId |
Постоянный идентификатор этого автора в вашем оффере. Используйте его как ключ в своей системе |
creator |
Имя автора на suly.gg |
channels |
Подтверждённые каналы автора. views и periodDays — просмотры канала за последние 28 или 30 дней либо null; countries — доли аудитории в процентах либо пустой список |
code, link |
То, что вы выдали автору, либо null |
rejectReason |
Ваша причина, если вы отказали, либо null |
info |
Ваша заметка автору: { "text", "updatedAt" } либо null |
accrued |
Сколько этому автору уже выплачено в этом оффере |
GET /participants/{participantId}
Заголовок раздела «GET /participants/{participantId}»Один участник в том же формате.
POST /participants/{participantId}/code
Заголовок раздела «POST /participants/{participantId}/code»Выдайте автору код и ссылку или замените их в любой момент.
curl -s https://suly.gg/api/partner/v1/participants/$ID/code \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"code":"ANDRY","link":"https://partner.example/r/ANDRY"}'| Поле | Правила |
|---|---|
code |
1–100 символов |
link |
Адрес https://, до 1000 символов |
В ответе — участник, теперь со статусом active. Автор сразу видит новые код и ссылку. Код, отправленный автору, которому отказали, снова делает его участником.
POST /participants/{participantId}/reject
Заголовок раздела «POST /participants/{participantId}/reject»Откажите автору с причиной, которую он увидит.
curl -s https://suly.gg/api/partner/v1/participants/$ID/reject \ -H "Authorization: Bearer $SULY_KEY" \ -H 'Content-Type: application/json' \ -d '{"reason":"The audience does not fit"}'reason — от 1 до 500 символов. В ответе — участник, теперь со статусом rejected. Отказ никогда не затрагивает уже начисленные деньги.