Skip to main content

comece em três passos

integre com nossa API do dashboard backend e faça sua primeira requisição.

passo 1: obtenha suas credenciais

para acessar endpoints protegidos, você precisará de um token JWT válido.faça uma requisição para o endpoint de login:
curl -X POST https://backend.testeswaffle.org/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "sua_senha"}'
guarde o token retornado - você precisará dele para requisições autenticadas.
primeiro, teste um endpoint que não requer autenticação:
curl https://backend.testeswaffle.org/referrals/count
se retornar dados JSON, a API está funcionando!

passo 2: faça sua primeira requisição autenticada

agora teste um endpoint que requer autenticação usando o token obtido:
curl -H "Authorization: Bearer SEU_JWT_TOKEN" \
     https://backend.testeswaffle.org/referrals
substitua SEU_JWT_TOKEN pelo token real retornado no passo anterior.
nossa API gerencia múltiplos tipos de dados:
  • referrals: sistema de indicações
  • streaks: gamificação de leitura
  • metrics: métricas de ads
  • newsletters: gestão de cadernos
  • forms: formulários dinâmicos
comece explorando os endpoints de referrals - são os mais utilizados!

passo 3: integre com sua aplicação

agora você pode integrar nossa API em qualquer linguagem:JavaScript/Node.js:
const response = await fetch('https://backend.testeswaffle.org/referrals', {
  headers: {
    'Authorization': `Bearer ${token}`,
    'Content-Type': 'application/json'
  }
});
const data = await response.json();
Python:
import requests

headers = {
    'Authorization': f'Bearer {token}',
    'Content-Type': 'application/json'
}
response = requests.get('https://backend.testeswaffle.org/referrals', headers=headers)
data = response.json()

próximos passos 🎯

agora que você já fez sua primeira requisição, explore nossas principais funcionalidades:

exemplos práticos 💡

dashboard de indicações

// buscar indicações do usuário
const referrals = await api.get('/referrals', {
  params: { email: '[email protected]' }
});

ranking de streaks

// obter ranking de leitores
const ranking = await api.get('/streaks/ranking');
precisa de ajuda? 🤝 veja nossa documentação completa ou nos contate via suporte.