Participantes
Um participante é um criador que entrou na sua oferta.
| Status | Significado |
|---|---|
pending |
Entrou e aguarda um código seu |
active |
Tem um código e um link; pode receber créditos |
rejected |
Recusado por você; o criador vê o seu motivo |
GET /participants
Seção intitulada “GET /participants”curl -s "https://suly.gg/api/partner/v1/participants?status=pending&page=1" \ -H "Authorization: Bearer $SULY_KEY"status é pending, active, rejected ou all (o padrão). 50 por página, os mais novos primeiro.
{ "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}| Campo | Significado |
|---|---|
participantId |
Id estável deste criador na sua oferta. Use-o como chave no seu sistema |
creator |
O nome do criador na suly.gg |
channels |
Os canais verificados do criador. views e periodDays são as visualizações do canal nos últimos 28 ou 30 dias, ou null; countries é a fatia do público em percentual, ou uma lista vazia |
code, link |
O que você deu ao criador, ou null |
rejectReason |
O seu motivo, se você recusou, ou null |
info |
A sua nota para o criador: { "text", "updatedAt" }, ou null |
accrued |
Quanto este criador já recebeu nesta oferta |
GET /participants/{participantId}
Seção intitulada “GET /participants/{participantId}”Um participante, no mesmo formato.
POST /participants/{participantId}/code
Seção intitulada “POST /participants/{participantId}/code”Dê a um criador um código e um link, ou substitua-os a qualquer momento.
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"}'| Campo | Regras |
|---|---|
code |
De 1 a 100 caracteres |
link |
Um endereço https://, até 1.000 caracteres |
A resposta é o participante, agora active. O criador vê o novo código e o novo link na hora. Um código enviado a um criador recusado faz dele um participante de novo.
POST /participants/{participantId}/reject
Seção intitulada “POST /participants/{participantId}/reject”Recuse um criador com um motivo que ele verá.
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 tem de 1 a 500 caracteres. A resposta é o participante, agora rejected. A recusa nunca afeta o dinheiro que já foi creditado.