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

Учасники

Учасник — це автор, який долучився до вашого офера.

Статус Що означає
pending Долучився й чекає від вас на код
active Має код і посилання; може отримувати нарахування
rejected Ви йому відмовили; автор бачить вашу причину
Terminal window
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 Скільки цьому автору вже виплачено в цьому офері

Один учасник у тому самому форматі.

Видайте автору код і посилання або замініть їх будь-коли.

Terminal window
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. Автор одразу бачить нові код і посилання. Код, надісланий автору, якому відмовили, знову робить його учасником.

Відмовте автору з причиною, яку він побачить.

Terminal window
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. Відмова ніколи не зачіпає вже нараховані гроші.