Acesso e formatos
URL base
Seção intitulada “URL base”https://suly.gg/api/partner/v1A chave
Seção intitulada “A chave”Toda requisição leva o cabeçalho:
Authorization: Bearer suly_…- A chave tem o formato
suly_seguido de 43 caracteres (48 no total). - Você a cria na página da oferta no painel da marca, no bloco Chave de API, depois que a oferta é aprovada. Cada oferta tem sua própria chave.
- Ela é exibida uma única vez. Substituir chave emite uma nova, e a chave antiga para de funcionar na hora (
401). - Mantenha-a em segredo: guarde-a em uma variável de ambiente ou em um cofre de segredos, nunca no código, em logs ou em um navegador.
Requisições e respostas
Seção intitulada “Requisições e respostas”- JSON na entrada e na saída. Todo
POSTenviaContent-Type: application/json. - Campos desconhecidos e parâmetros de consulta desconhecidos são recusados com
400 INVALID_INPUT. - Os horários são ISO 8601 em UTC:
2026-11-03T10:00:00.000Z.
Dinheiro
Seção intitulada “Dinheiro”Dinheiro é uma string em dólares americanos, com ponto e no máximo seis casas decimais: "12.5", "0.01". As respostas sempre têm seis casas decimais: "12.500000". Nunca envie dinheiro como um número JSON.
Paginação
Seção intitulada “Paginação”As listas devolvem 50 itens por página, os mais novos primeiro:
{ "participants": [], "total": 0, "page": 1, "pageSize": 50 }Peça a próxima página com ?page=2.
Limites
Seção intitulada “Limites”Requisições sequenciais bastam para qualquer integração. Se você receber 429 ou 503, aguarde e repita a requisição mais tarde.