Учасники
Учасник — це автор, який долучився до вашого офера.
| Статус | Що означає |
|---|---|
pending |
Долучився й чекає від вас на код |
active |
Має код і посилання; може отримувати нарахування |
rejected |
Ви йому відмовили; автор бачить вашу причину |
GET /participants
Section titled “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}
Section titled “GET /participants/{participantId}”Один учасник у тому самому форматі.
POST /participants/{participantId}/code
Section titled “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
Section titled “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. Відмова ніколи не зачіпає вже нараховані гроші.