Explorar documentação
Primeiros passos
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
- Entre em sua conta verificada e abra API Keys. Reutilize uma chave autorizada se já tiver uma.
- 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.
- 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.
# 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# PowerShell 7: paste the key into a hidden prompt.
$flashdataSecureKey = Read-Host "FlashData API key" -AsSecureString
$env:FLASHDATA_API_KEY = [System.Net.NetworkCredential]::new("", $flashdataSecureKey).Password
Remove-Variable flashdataSecureKeyColar a chave no alerta escondido. Para um perfil nomeado, adicione o nome --profile aqui e em comandos posteriores. Um perfil previamente configurado requer login --replace para substituir sua chave.
flashdata auth login3. 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.
(
: "${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'
)Reutilize o FLASHDATA_API_KEY do check-in anterior no mesmo terminal.
& {
$ErrorActionPreference = 'Stop'
if ([string]::IsNullOrWhiteSpace($env:FLASHDATA_API_KEY)) {
throw 'Set FLASHDATA_API_KEY first'
}
$flashdataHeaders = @{ 'X-API-Key' = $env:FLASHDATA_API_KEY }
$flashdataBase = 'https://api.flashdata.dev/v2'
$flashdataUri = "$flashdataBase/api-access/identity"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}Use seu acesso CLI salvo. Para um perfil nomeado, adicione o nome --profile a cada comando. Essas leituras não gastam créditos de consulta.
flashdata auth statusConfirme 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ção | Esperado |
|---|---|
| accountId | A conta que é dona dessa carga de trabalho. |
| access | ready |
| scopes | Inclui google_search para a primeira busca. |
| recurringAllowed | Verdade 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
- Revogar a chave exposta imediatamente na página correspondente do console abaixo, e parar seus ouvintes programados.
- 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.
- Revise History e use a conta para atividade inesperada. Remover um segredo de um arquivo não o revoga.
Rodar uma chave
- Criar uma substituição com as fontes necessárias e instalá-lo no ambiente alvo.
- Repita a verificação livre acima, e depois mude o aplicativo ou agendador. Atualize cada chamador.
- Revogar a velha chave depois que os ouvintes trocarem. Um segredo atualizado no seu laptop não atualiza os serviços implantados.
flashdata auth login --replace
flashdata auth statusRevogar 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 acesso | Onde revogar? |
|---|---|
| Chave comum de API | API Keys |
| Chave de agente reivindicada | Settings → Connected apps → Agent connections |
| MCP OAuth concessão | Settings → Connected apps |