> ## Documentation Index
> Fetch the complete documentation index at: https://docs.noimosai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Autenticar solicitações

> Chaves Developer Platform, permissões, validade e gestão segura.

## 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.

```http theme={null}
Authorization: Bearer nmp_...
```

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.

| Chave | Destino | Dados | Cobrança |
| - | - | - | - |
| `nmp_` | Developer Platform API | Projetos de desenvolvedor, execuções e artefatos | Saldo pré-pago em USD |
| Chave API normal do NoimosAI | CLI, Local MCP, API de ferramentas normal | Espaço de trabalho NoimosAI | Créditos NoimosAI |

> [!WARNING]
>
> 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.

| Permissão | Operações permitidas |
| - | - |
| `project:read` | Consultar organização e projeto da chave |
| `usage:read` | Consultar uso consolidado e custos em USD do mês atual |
| `tools:read` | Obter catálogo e cotações gratuitas |
| `tools:execute` | Enviar entradas, executar e cancelar trabalho pago |
| `executions:read` | Obter estado, resultados e URLs de artefatos |

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.

* [Primeiros passos](https://docs.noimosai.com/pt/developers/api/getting-started.md)
* [Referência da API](https://docs.noimosai.com/pt/developers/api/reference.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.