Sua chave de API funciona como uma senha: ela permite que seu agente de IA ou seu software use APIs na sua conta, e cada chamada é cobrada de você. Uma única chave funciona para todas as APIs do Zyla API Hub, o servidor Zyla MCP e a Listings API.
Se você usa um agente de IA, quase nunca precisa tocar nela: a linha de configuração em Conectar agentes de IA (MCP) já a inclui.
Obtenha sua chave
- Cadastre-se ou faça login.
- Abra Conectar agentes de IA (MCP). Sua chave aparece em Sua chave de acesso à API, com um botão Copy. Todas as suas chaves também estão em API keys, no menu da conta.
Use-a no seu código
Desenvolvedores a enviam no header Authorization de toda requisição:
Authorization: Bearer YOUR_API_KEY
Crie mais chaves
Abra API keys no menu da conta (/api_keys) para:
- criar chaves adicionais com um nome, por exemplo uma por projeto ou ambiente;
- limitar uma chave a APIs específicas, para que uma chave vazada não possa ser usada contra o resto das suas assinaturas;
- revogar uma chave a qualquer momento. Requisições feitas com uma chave revogada recebem
401.
Uma chave limitada a algumas APIs recebe 403 quando chama uma API fora da sua lista.
Mantenha-a em segredo
- Não coloque a chave em código do lado do cliente (JavaScript no navegador, apps mobile). Chame a Zyla a partir do seu backend.
- Não a comite em um repositório. Carregue-a a partir de uma variável de ambiente ou de um gerenciador de secrets.
- Se uma chave vazar, revogue-a em API keys e crie uma nova.
