Autenticação

​

Visão geral

​

Gerando uma API Key

1. Acesse Configurações → Developers no painel da SocialSell
2. Clique em Nova API Key
3. Dê um nome descritivo (ex: Integração ERP, Zapier)
4. Selecione os escopos necessários
5. Copie e armazene a chave com segurança — ela só é exibida uma vez

​

Enviando a chave

Authorization: Bearer sk_live_sua_chave_aqui

​

Exemplo completo

curl https://api.socialsell.ai/v1/contacts \
  -H "Authorization: Bearer sk_live_abc123xyz" \
  -H "Content-Type: application/json"

​

Erros de autenticação

​

Exemplo de erro

{
  "error": {
    "type": "unauthorized",
    "message": "API key inválida, expirada ou revogada.",
    "code": "INVALID_API_KEY"
  },
  "meta": {
    "request_id": "req_01jx8kz3m4n5p6q7r8s9t0u1v"
  }
}

​

Boas práticas

• Nunca exponha a chave no frontend — use sempre do lado servidor
• Use uma chave por integração — facilita revogar acessos específicos
• Defina apenas os escopos necessários — princípio do menor privilégio
• Rotacione chaves periodicamente — especialmente após mudanças de equipe
• Monitore o uso — logs de uso estão disponíveis no painel em Developers

​

Escopos disponíveis