Entender o que pertence à conta

Saldo e chaves pertencem à conta. Um projeto separa as métricas e aplica limites próprios, mas suas chamadas debitam do mesmo saldo. Crie projetos para distinguir clientes, produtos ou ambientes operacionais sem perder a visão consolidada.

O projeto selecionado no header muda as listagens e o contexto do painel. Na API, envie X-Project-Id para escolher explicitamente o projeto da chamada. Uma chave vinculada a um projeto só aceita o projeto dela.

Usar o projeto padrão

Sua conta nasce com um projeto padrão. Se uma chave de conta inteira fizer uma chamada sem X-Project-Id, a API usa esse projeto. Ele não pode ser arquivado, para que sempre exista um destino válido para as chamadas sem header.

Criar um projeto

  1. Abra Projetos e clique em Criar projeto.
  2. Dê um nome claro, como o cliente ou produto atendido.
  3. Escolha uma cor e, se quiser, um logotipo para reconhecê-lo no painel.
  4. Depois de criar, selecione o projeto no header para ver seus dados.

A cor e o logotipo ajudam a identificar o projeto; não alteram o acesso. Para isolar uma integração, crie uma chave com vínculo Somente o projeto na tela Chaves de API.

Tela de projetos com o projeto padrão e outro projeto selecionado
Projetos e limites no painel de teste, com dados fictícios.

Definir limite de gasto

Configure um limite de gasto diário ou mensal para controlar o consumo do projeto. O limite é específico do projeto e não cria um saldo separado. A conta continua usando sua carteira compartilhada. Acompanhe o gasto em Chamadas e em Saldo e extrato.

A tela também permite uma allowlist de IP. Quando configurada, somente os endereços autorizados podem chamar em nome do projeto; um IP fora da lista recebe 403 ip_not_allowed. Antes de ativar, inclua os IPs de saída de todos os seus servidores.

Arquivar sem perder o histórico

Arquive um projeto que não deve receber novas chamadas. O histórico permanece para consulta, mas novas chamadas para esse projeto passam a retornar 400. Atualize ou pare suas integrações antes de arquivar. O projeto padrão não pode ser arquivado.

Respostas rápidas

Recebe as chamadas sem `X-Project-Id`. Ele nasce com a conta e não pode ser arquivado.

Próximos passos

Chaves de API

Vincule a chave ao projeto certo.

Segurança

Proteja o projeto com allowlist de IP.

Allowlist de IP

Regras e erros da restrição por endereço.