Skip to main content
A API pública da Sortify permite integrar suas ações (sorteios) a sistemas externos: consulte as ações ativas da sua conta, acompanhe o progresso de vendas em tempo real e construa automações em cima da plataforma.

​
Base URL

Todas as requisições usam a seguinte base: 
https://api.sortify.com.br

​
Comece em 3 passos

1

Crie uma credencial

No painel da Sortify, crie uma credencial de API. Você recebe um par de tokens: público (pb_...) e secreto (sk_...).
2

Guarde o token secreto

O token secreto é exibido apenas uma vez. Armazene-o em um gerenciador de segredos — ele não pode ser recuperado depois.
3

Faça sua primeira requisição

curl -u "pb_SEU_TOKEN_PUBLICO:sk_SEU_TOKEN_SECRETO" \
  "https://api.sortify.com.br/v1/raffles"

​
Explore a API

Autenticação

Como funciona o par de tokens e o HTTP Basic Auth

Listar ações

Todas as ações ativas e em andamento da sua conta

Obter ação

Detalhes completos de uma ação, com imagens e progresso de vendas

Painel Sortify

Crie e gerencie suas credenciais de API

​
Formato das respostas

Todas as respostas são JSON com o envelope padrão: 
{
  "success": true,
  "message": "Ações listadas com sucesso",
  "data": {}
}
  • message: texto em português, adequado para exibição ao usuário final.
  • code: código estável em inglês, adequado para tratamento programático.

​
Convenções

  • Valores monetários são sempre inteiros em centavos (ex.: ticket_price: 199 = R$ 1,99). Divida por 100 para exibir em reais.
  • Datas são strings ISO 8601 em UTC (sufixo Z).
  • IDs são UUIDs.

​
Limites de requisição

Cada credencial pode realizar até 120 requisições por minuto. Ao exceder o limite, a API responde com HTTP 429 e o código RATE_LIMIT_EXCEEDED.
As respostas de listagem são atualizadas a cada 15 segundos. Não há necessidade de consultar a API em intervalos menores que esse.