Pular para o conteúdo
PT
Obter chave API
Explorar documentação

Primeiros passos

Gerenciar chaves de API

Crie uma chave para o seu aplicativo ou agente. Guarde-o, verifique o acesso e gerencie seu ciclo de vida.

Nesta página

1. Crie uma chave

  1. Entre em sua conta verificada e abra API Keys. Reutilize uma chave autorizada se já tiver uma.
  2. Nomeie-o para o aplicativo e ambiente, selecione uma expiração e escolha as fontes que precisa. Selecione Google Search para o primeiro exemplo de busca.
  3. Crie a chave e guarde-a abaixo. Dê a agentes independentes e aplicativos de produção chaves separadas para que possa revogá-los individualmente.

2. Guarde a chave

Escolha o jeito que você vai executar FlashData. API e SDK exemplos ler FLASHDATA_API_KEY; o CLI pode salvar a chave em seu perfil protegido. Na produção, injete credenciais de sua loja secreta.

Defina a chave para este terminal
# Bash: paste the key into a hidden prompt, not into this command.
read -r -s -p "FlashData API key: " FLASHDATA_API_KEY
printf '\n'
export FLASHDATA_API_KEY

3. Verifique o acesso

Faça a verificação gratuita no mesmo terminal ou perfil CLI. Use a guia que combina com como você guardou a chave.

Reutilize o FLASHDATA_API_KEY do check-in anterior no mesmo terminal.

Leia a conta JSON
(
: "${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY first}"
curl --fail-with-body --silent --show-error --max-time 20 \
  --header "X-API-Key: $FLASHDATA_API_KEY" \
  'https://api.flashdata.dev/v2/api-access/identity' || exit
printf '\n'
)

Confirme a conta e a fonte

HTTP retorna esses campos diretamente. Com CLI JSON, encontrá-los sob data.identity.identity e também exigir data.accessVerified: true.

verificaçãoEsperado
accountIdA conta que é dona dessa carga de trabalho.
accessready
scopesInclui google_search para a primeira busca.
recurringAllowedVerdade antes do trabalho do proprietário.

Como as permissões da fonte funcionam

Uma chave só pode usar suas fontes garantidas. A seleção de produtos está separada dos preços: cada chave na conta gasta do saldo compartilhado, incluindo créditos comprados. Uma chave restrita não tem seu próprio limite de gastos. Produtos futuros exigem uma autorização explícita.

Se uma chave for exposta

  1. Revogar a chave exposta imediatamente na página correspondente do console abaixo, e parar seus ouvintes programados.
  2. Criar uma substituição com as permissões necessárias, instalá-la na loja secreta de cada pessoa, e executar a verificação gratuita acima.
  3. Revise History e use a conta para atividade inesperada. Remover um segredo de um arquivo não o revoga.

Rodar uma chave

  1. Criar uma substituição com as fontes necessárias e instalá-lo no ambiente alvo.
  2. Repita a verificação livre acima, e depois mude o aplicativo ou agendador. Atualize cada chamador.
  3. Revogar a velha chave depois que os ouvintes trocarem. Um segredo atualizado no seu laptop não atualiza os serviços implantados.
Substitua uma chave CLI.
flashdata auth login --replace
flashdata auth status

Revogar o acesso

Pare as chamadas programadas, revogue a chave ou conexão correspondente abaixo, então repita a verificação gratuita com a velha credencial. Deve ser rejeitada. Sair localmente não revoga o acesso ao servidor.

Tipo de acessoOnde revogar?
Chave comum de APIAPI Keys
Chave de agente reivindicadaSettings → Connected apps → Agent connections
MCP OAuth concessãoSettings → Connected apps