Saltar para o conteúdo principal

​
Visão geral

Esta página explica autenticação, permissões, validade e armazenamento de chaves Developer Platform. Cada chave pertence a um projeto e permite apenas as operações autorizadas.

​
Usar uma chave Developer Platform

Envie este cabeçalho Authorization em todas as solicitações.
As chaves das configurações normais da equipe usam espaços de trabalho, suas permissões e créditos NoimosAI. As da Developer Platform usam projetos, permissões e saldos pré-pagos em USD separados.
As chaves não são intercambiáveis. Chaves inválidas, permissões ou saldo insuficientes não provocam mudança automática de autenticação ou cobrança.

​
Definir permissões

Selecione as permissões necessárias ao criar a chave. Separe chaves de teste de conexão das de execução paga para limitar ações acidentais. Verifique todas as permissões para projeto, cotação, execução e resultados.

​
Quem pode criar chaves

Membros ADMIN ou DEVELOPER do projeto podem criar chaves. Mesmo administradores da organização precisam participar explicitamente do projeto para acessá-lo. Aplicam-se as permissões do criador e do projeto. A chave deixa de funcionar se o criador for desativado ou removido do projeto, ou se ela for revogada.

​
Gerenciar a validade

Escolha a validade na tela de criação de chaves da Developer Platform e confira-a na lista após a criação. A chave completa aparece uma única vez; salve-a com segurança antes de fechar a tela. Antes do vencimento, crie outra chave, atualize os usos e revogue a antiga. Revogue imediatamente se houver suspeita de vazamento.

​
Armazenar chaves com segurança

Trate as chaves como segredos do servidor, nunca distribuídos aos navegadores dos usuários.
  • Use variáveis de ambiente ou um gerenciador de segredos.
  • Não registre em Git, logs, telas de erro ou eventos analíticos.
  • Não incorpore em aplicativos web ou móveis.
  • Separe chaves e projetos de produção, homologação e desenvolvimento.
  • Crie chaves por finalidade com permissões mínimas.

​
Resolver erros de autenticação

Verifique o status HTTP e o estado da chave.
  • 401 — Verifique Authorization, chave completa, validade e revogação.
  • 403 — Verifique permissões necessárias e acesso do proprietário ao projeto.
  • 429 — Verifique limites de solicitações, saldo e tetos mensais da organização ou projeto.
Se houver dúvida sobre chave e endpoint, use GET /tools/project antes de enviar trabalho pago.

​
Páginas relacionadas

Estas páginas explicam criação de chaves e especificações comuns.