Pular para o conteúdo

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
Janela do terminal
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

Um participante, no mesmo formato.

Dê a um criador um código e um link, ou substitua-os a qualquer momento.

Janela do terminal
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.

Recuse um criador com um motivo que ele verá.

Janela do terminal
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.