Autenticação
A API do SuperSquad usa API Keys para autenticação.
Obtendo sua API Key
- Acesse Settings no menu
- Vá para API Keys
- Clique em Gerar Nova Key
- Copie e guarde sua key em local seguro
⚠️ A API Key é exibida apenas uma vez. Guarde-a em um local seguro.
Usando a API Key
Inclua o header Authorization em todas as requisições:
bashcurl -X GET "https://api.supersquad.com/v1/agents" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json"
SDK
Node.js
typescriptimport { SuperSquad } from '@supersquad/sdk'; const client = new SuperSquad({ apiKey: process.env.SUPERSQUAD_API_KEY, });
Python
pythonfrom supersquad import SuperSquad client = SuperSquad(api_key=os.environ["SUPERSQUAD_API_KEY"])
Escopos de permissão
Configure permissões específicas para cada key:
| Escopo | Descrição |
|---|---|
agents:read | Ler agentes |
agents:write | Criar/editar agentes |
contacts:read | Ler contatos |
contacts:write | Criar/editar contatos |
messages:read | Ler mensagens |
messages:write | Enviar mensagens |
Rate Limits
| Plano | Requisições/min |
|---|---|
| Free | 60 |
| Pro | 300 |
| Enterprise | Ilimitado |
Erros de autenticação
json{ "error": { "code": "unauthorized", "message": "Invalid API key" } }
Códigos de status:
401- API Key inválida ou ausente403- Permissão negada (escopo insuficiente)429- Rate limit excedido