quickstart.mdx

title	início rápido
description	comece a usar nossa API em minutos

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:
```bash
curl -X POST https://backend.testeswaffle.org/auth/login \
  -H "Content-Type: application/json" \
  -d '{"email": "[email protected]", "password": "sua_senha"}'
```

<Tip>guarde o token retornado - você precisará dele para requisições autenticadas.</Tip>

primeiro, teste um endpoint que não requer autenticação: ```bash 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:

```bash
curl -H "Authorization: Bearer SEU_JWT_TOKEN" \
     https://backend.testeswaffle.org/referrals
```

<Warning>substitua `SEU_JWT_TOKEN` pelo token real retornado no passo anterior.</Warning>

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

<Tip>comece explorando os endpoints de referrals - são os mais utilizados!</Tip>

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:

implemente indicações com anti-fraude e gamificação. adicione streaks, missões e rankings aos seus usuários. acesse dados unificados do Facebook, TikTok e Google Ads. gerencie múltiplos cadernos e subscribers.

exemplos práticos 💡

```javascript // buscar indicações do usuário const referrals = await api.get('/referrals', { params: { email: '[email protected]' } }); ``` ```javascript // obter ranking de leitores const ranking = await api.get('/streaks/ranking'); ``` **precisa de ajuda?** 🤝 veja nossa [documentação completa](/api-reference/introduction) ou nos contate via [suporte](mailto:[email protected]).