Autenticação

A API OctaLife usa API Keys para autenticação. Cada chave está vinculada à sua conta de creator e tem acesso a todas as suas tribos.

Formato da API Key

Use chaves ol_test_ para desenvolvimento e ol_live_ para produção.

Obtendo suas Chaves

Formato do Header

Authorization: Bearer ol_live_sua_chave_aqui
Content-Type: application/json

Exemplos

curl -X GET https://app.octalife.ai/api/v1/communities \
  -H "Authorization: Bearer ol_live_sua_chave_aqui" \
  -H "Content-Type: application/json"

const apiKey = process.env.OCTALIFE_API_KEY;

const response = await fetch('https://app.octalife.ai/api/v1/communities', {
  headers: {
    'Authorization': `Bearer ${apiKey}`,
    'Content-Type': 'application/json'
  }
});

const data = await response.json();

import os, requests

response = requests.get(
    'https://app.octalife.ai/api/v1/communities',
    headers={
        'Authorization': f'Bearer {os.environ["OCTALIFE_API_KEY"]}',
        'Content-Type': 'application/json'
    }
)

Vinculação com Creator

Cada API Key está vinculada à sua conta de creator e tem acesso a todas as suas tribos. Permite:

• Controle de acesso: chaves separadas por ambiente ou aplicação
• Isolamento: só acessa tribos que você criou
• Auditoria: requisições rastreadas por chave

Gerenciamento de Chaves

Revogando

1. Acesse Configurações → API Keys
2. Localize a chave pelo prefixo
3. Clique em "Revogar"

Rotação

Recomendamos rotacionar chaves a cada 90 dias:

1. Gere nova chave
2. Atualize aplicações
3. Verifique funcionamento
4. Revogue a antiga

Erros de Autenticação

{
  "success": false,
  "error": {
    "code": "UNAUTHORIZED",
    "message": "API Key inválida ou ausente"
  }
}

Boas Práticas

Faça

• Variáveis de ambiente ou secrets manager
• Rotação a cada 90 dias
• Chaves de teste pra desenvolvimento
• Monitorar uso

Não faça

• Commitar chaves no Git
• Expor chaves em frontend ou logs
• Compartilhar entre devs sem rastreabilidade
• Usar chave de teste em produção

Suporte

• Email: suporte@octalife.ai
• Documentação: Início Rápido