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 |
GET /participants
Dział zatytułowany „GET /participants”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 |
GET /participants/{participantId}
Dział zatytułowany „GET /participants/{participantId}”Jeden uczestnik w tym samym formacie.
POST /participants/{participantId}/code
Dział zatytułowany „POST /participants/{participantId}/code”Wydaj twórcy kod i link albo zastąp je w dowolnej chwili.
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.
POST /participants/{participantId}/reject
Dział zatytułowany „POST /participants/{participantId}/reject”Odmów twórcy, podając powód, który zobaczy.
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.