Autenticação
Como autenticar suas requisições à API
Autenticação
A API eternalsocial.dev usa Bearer tokens para autenticação. Você pode usar uma API Key ou um JWT token.
API Keys
API Keys são a forma recomendada de autenticação para aplicações em produção.
Criar uma API Key
- Acesse o Dashboard
- Clique em Criar Chave API
- Dê um nome descritivo (ex: "Produção", "Desenvolvimento")
- Copie a chave gerada - ela só será mostrada uma vez
Usar a API Key
Inclua a chave no header Authorization:
curl -X GET 'https://api.eternalsocial.dev/accounts' \
-H 'Authorization: Bearer sk_live_abc123...'Nunca exponha sua API Key no código frontend. Use sempre variáveis de ambiente e faça as chamadas pelo backend.
JWT Tokens
JWT tokens são usados para autenticação de usuários no dashboard e aplicações que precisam de sessões.
Obter um token
curl -X POST 'https://api.eternalsocial.dev/auth/login' \
-H 'Content-Type: application/json' \
-d '{
"email": "seu@email.com",
"password": "sua_senha"
}'Resposta:
{
"token": "eyJhbGciOiJIUzI1NiIs...",
"user": {
"id": "user_123",
"email": "seu@email.com"
}
}Usar o token
curl -X GET 'https://api.eternalsocial.dev/accounts' \
-H 'Authorization: Bearer eyJhbGciOiJIUzI1NiIs...'Rate Limits
| Tipo | Limite |
|---|---|
| Requisições por minuto | 60 |
| Requisições por hora | 1000 |
| Requisições por dia | 10000 |
Precisa de limites maiores? Entre em contato pelo suporte.
Erros de Autenticação
| Código | Descrição |
|---|---|
| 401 | Token inválido ou expirado |
| 403 | Sem permissão para este recurso |
| 429 | Rate limit excedido |
{
"error": "Unauthorized",
"message": "Invalid or expired token"
}