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

Участники

Участник — это автор, который присоединился к вашему офферу.

Статус Что означает
pending Присоединился и ждёт от вас код
active У него есть код и ссылка; может получать начисления
rejected Вы ему отказали; автор видит вашу причину
Окно терминала
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 Сколько этому автору уже выплачено в этом оффере

Один участник в том же формате.

Выдайте автору код и ссылку или замените их в любой момент.

Окно терминала
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. Автор сразу видит новые код и ссылку. Код, отправленный автору, которому отказали, снова делает его участником.

Откажите автору с причиной, которую он увидит.

Окно терминала
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. Отказ никогда не затрагивает уже начисленные деньги.