Pular para o conteúdo

Acesso e formatos

https://suly.gg/api/partner/v1

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.
  • JSON na entrada e na saída. Todo POST envia Content-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 é 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.

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.

Requisições sequenciais bastam para qualquer integração. Se você receber 429 ou 503, aguarde e repita a requisição mais tarde.