Przejdź do głównej zawartości

Uczestnicy

Uczestnik to twórca, który dołączył do Twojej oferty.

Status Znaczenie
pending Dołączył i czeka na kod od Ciebie
active Ma kod i link; może otrzymywać naliczenia
rejected Odmówiłeś mu; twórca widzi Twój powód
Okno terminala
curl -s "https://suly.gg/api/partner/v1/participants?status=pending&page=1" \
-H "Authorization: Bearer $SULY_KEY"

status przyjmuje wartości pending, active, rejected lub all (domyślnie). Po 50 na stronę, od najnowszych.

{
"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
}
Pole Znaczenie
participantId Stały identyfikator tego twórcy w Twojej ofercie. Używaj go jako klucza w swoim systemie
creator Nazwa twórcy w suly.gg
channels Zweryfikowane kanały twórcy. views i periodDays to wyświetlenia kanału z ostatnich 28 lub 30 dni albo null; countries to udział widowni w procentach albo pusta lista
code, link To, co wydałeś twórcy, albo null
rejectReason Twój powód, jeśli odmówiłeś, albo null
info Twoja notatka do twórcy: { "text", "updatedAt" } albo null
accrued Ile temu twórcy już wypłacono w tej ofercie

Jeden uczestnik w tym samym formacie.

Wydaj twórcy kod i link albo zastąp je w dowolnej chwili.

Okno terminala
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"}'
Pole Zasady
code 1–100 znaków
link Adres https://, do 1000 znaków

Odpowiedzią jest uczestnik, teraz ze statusem active. Twórca od razu widzi nowy kod i link. Kod przesłany twórcy, któremu odmówiono, ponownie czyni go uczestnikiem.

Odmów twórcy, podając powód, który zobaczy.

Okno terminala
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 ma od 1 do 500 znaków. Odpowiedzią jest uczestnik, teraz ze statusem rejected. Odmowa nigdy nie narusza pieniędzy, które zostały już naliczone.