Início › Desenvolvedores › Autenticação

Autenticação

Toda chamada leva a chave da integração no cabeçalho Authorization. A chave define a empresa, o ambiente, as permissões e os agentes: nenhum parâmetro muda isso.

Cabeçalho

GET /api/developers/v1/me HTTP/1.1
Host: aideed.com.br
Authorization: Bearer aid_live_<id>_<segredo>

• aid_test_…: ambiente de testes. Agentes de exemplo, nada é executado de verdade, nada é cobrado.
• aid_live_…: produção. Os agentes contratados pela empresa, contando a cota do mês.

Permissões (scopes)

Scope	Permite
workforce:read	Ler o Workforce e o consumo
agents:read	Ler os agentes autorizados e suas capacidades
tasks:write	Criar tarefas
tasks:read	Ler tarefas e resultados
tasks:cancel	Cancelar tarefas
webhooks:manage	Gerenciar webhooks

No painel, a empresa escolhe um conjunto pronto: Somente leitura (workforce:read, agents:read, tasks:read); Tarefas (workforce:read, agents:read, tasks:write, tasks:read, tasks:cancel); Completo (workforce:read, agents:read, tasks:write, tasks:read, tasks:cancel, webhooks:manage).

Troca e revogação

• Nova chave cria uma segunda chave válida: troque no seu sistema e revogue a antiga.
• Revogar uma chave, suspender ou revogar a integração vale na hora: a próxima chamada recebe 401.
• A AIDeed guarda só um resumo criptográfico da chave. Perdeu a chave? Gere outra.

Nunca coloque a chave em código de navegador ou de app móvel. Chame a API a partir do seu servidor.

Mais do portal

Comece aqui: Visão geral · Primeiros passos

Guias: Autenticação · Conceitos · Tarefas e aprovações · Webhooks · Erros · Limites e cota · Ambiente de testes · MCP do Workforce

Referência: Referência da API · Exemplos de código · Versões e mudanças

Dados públicos: API pública do catálogo · MCP do catálogo público