Autenticação e chaves de API
Como enviar a sua chave de API, quantas chaves você pode ter, o que uma chave pode e não pode fazer, o que fazer se uma vazar e como desconectar um assistente de IA.
Enviar a chave no cabeçalho Authorization
Authorization: Bearer YOUR_API_KEYEsse cabeçalho é o único lugar onde a API lê uma chave.
- Nunca coloque uma chave em uma URL (
?api_key=…). As URLs acabam em logs, no histórico do navegador e em links compartilhados. A API recusa uma requisição assim com400 api_key_in_query. Considere essa chave exposta: revogue-a e crie uma nova. - Chame exatamente
https://gloriads.com/api/v1: um cliente que segue um redirecionamento para outro endereço perde a sua chave no caminho. - Chame a API a partir de uma planilha, de um script ou de um servidor, não do código de uma página web: qualquer pessoa que visitasse a página poderia ler a chave.
O que uma chave pode fazer
- Ler a sua conta, em todos os endpoints.
- Não alterar nada. A API é somente leitura.
- Compartilhar os limites da sua conta: todas as suas chaves e todos os assistentes de IA conectados contam juntos, então uma segunda chave não dá mais requisições. Veja Limites e erros.
Criar uma chave
Configurações → API → Criar uma chave.
- O nome pode ter até 40 caracteres. Use o nome da ferramenta, para saber qual chave revogar depois.
- A chave é mostrada uma vez. Guardamos apenas uma impressão digital dela, então ninguém pode mostrá-la de novo — nem nós. Guarde-a em um gerenciador de senhas ou nas configurações secretas da sua ferramenta.
- Você pode ter 10 chaves ao mesmo tempo.
- A conta pública de demonstração não pode criar chaves.
A lista de chaves
Cada chave mostra o seu nome, os primeiros caracteres (key_live_ab12…), quando
foi criada e quando foi usada pela última vez.
“Último uso” é atualizado no máximo uma vez por hora, então uma chave usada há poucos minutos ainda pode mostrar um horário anterior.
Revogar uma chave
Abra o menu ⋯ da chave e depois Revogar.
Vale na hora: a próxima requisição com essa chave recebe 401 unauthorized, a
mesma resposta de uma chave que nunca existiu. Uma chave revogada não pode ser
restaurada — crie uma nova.
Assistentes de IA conectados sem chave
claude.ai e ChatGPT não usam chave: você entra no Gloriads a partir do assistente e clica em Permitir. O assistente recebe então um acesso próprio, que só pode ler. Como conectar um: Conectar um assistente de IA.
- Configurações → API → Aplicativos conectados lista cada assistente, o endereço que pediu o acesso, quando você o conectou e quando ele leu a sua conta pela última vez (atualizado no máximo uma vez por hora).
- Não verificado ao lado de um nome significa que o aplicativo se registrou sozinho, sem comprovar o seu endereço. Mantenha-o apenas se foi você quem o conectou.
- Para interromper um, abra o menu ⋯ dele e depois Desconectar. Vale na hora. Para usá-lo de novo, conecte-o de novo a partir do assistente.
Quando uma requisição é recusada
| Resposta | Por quê | O que fazer |
|---|---|---|
401 unauthorized | Sem cabeçalho Authorization, ou uma chave errada ou revogada | Confira o cabeçalho e a chave |
403 subscription_inactive | Sua assinatura terminou | Assine em Configurações → Cobrança |
400 api_key_in_query | A chave estava na URL | Passe-a para o cabeçalho e depois revogue-a |
Todos os outros códigos estão descritos em Limites e erros.
A chave pública de demonstração
A referência da API preenche o botão Try it com uma chave pública. Ela lê apenas a conta de demonstração e está limitada a 10 requisições por minuto, compartilhadas por todos os visitantes. Ela não consegue ler a sua conta: para isso, use a sua própria chave.