Como acessar a Zild API

Gere uma API Key de usuário, entenda o escopo de permissões e conecte ferramentas como Claude Code e Codex diretamente à API da Zild.

Gere sua API Key

  1. Entre na Zild e abra o seu Perfil.
  2. Localize a seção API Key e escolha a opção para gerar uma chave.
  3. Copie o valor gerado e armazene-o em um gerenciador de segredos seguro. Não inclua a chave em código-fonte, repositórios, logs, capturas de tela ou documentos compartilhados.
Perfil da Zild mostrando onde gerar uma API Key de usuário

Autentique as requisições

Envie a chave no header X-API-Key em todas as requisições à API da Zild:

X-API-Key: YOUR_USER_API_KEY

Exemplo:

curl --request GET \
  --url 'https://api.zild.ai/Agent' \
  --header 'X-API-Key: YOUR_USER_API_KEY'

A chave usa as suas permissões

Uma API Key gerada possui os mesmos acessos do usuário que a gerou. Ela pode consultar ou alterar somente os recursos que esse usuário tem permissão para acessar na Zild. Se os papéis, grupos, acesso ao tenant ou permissões do usuário mudarem, o acesso efetivo pela API também muda.

Trate a chave como uma credencial do usuário. Gere-a para a pessoa ou serviço com o escopo de permissões adequado, aplique o princípio do menor privilégio e substitua-a imediatamente caso possa ter sido exposta.

Use com agentes de programação

Você pode fornecer a API Key com segurança a ferramentas desktop como Claude Code e Codex para que um agente use a API da Zild diretamente. Armazene-a na configuração de segredos ou de ambiente da ferramenta e instrua o agente a enviar X-API-Key: YOUR_USER_API_KEY nas requisições para https://api.zild.ai.

O agente não recebe privilégios adicionais na Zild: toda ação pela API continua limitada aos acessos do usuário que gerou a chave. Revise as permissões e a operação solicitada antes de permitir que um agente use a credencial.