# Gerenciar chaves de API

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

Referência canônica: https://flashdata.dev/pt/docs/guides/api-keys-and-permissions
2026-11-04 por FlashData

<a id="create"></a>

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

- [Abrir API Keys](https://flashdata.dev/app/api-keys)
- [Tente antes de se inscrever](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md)

<a id="store"></a>

## 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 · API / SDK

#### Defina a chave para este terminal

```bash
# 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 · API / SDK

#### Defina a chave para este terminal

```powershell
# 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 flashdataSecureKey
```


### CLI

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

#### Salve a chave

```bash
flashdata auth login
```

- [Instalação CLI](https://flashdata.dev/pt/docs/guides/flashdata-cli/reference.md#install)


<a id="verify"></a>

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

### Bash / cURL

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

#### Leia a conta JSON

```bash
(
: "${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'
)
```


### PowerShell 7

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

#### Leia a conta JSON

```powershell
& {
  $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
}
```


### CLI

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.

#### Conta livre lê

```bash
flashdata auth status
```

- [Prepare uma chave](https://flashdata.dev/pt/docs/guides/api-keys-and-permissions/reference.md#store)


<a id="verified"></a>

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

- [Faça sua primeira consulta](https://flashdata.dev/pt/docs/guides/http-quickstart/reference.md)
- [Verifique o equilíbrio e os preços](https://flashdata.dev/pt/docs/guides/credits-and-billing/reference.md)

<a id="permissions"></a>

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

- [Catálogo de permissão do agente](https://flashdata.dev/pt/docs/guides/agent-onboarding/reference.md#permissions)

<a id="leak"></a>

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

- [API Keys](https://flashdata.dev/app/api-keys)
- [Uso da conta](https://flashdata.dev/pt/docs/guides/usage-and-limits/reference.md#usage)

<a id="rotate"></a>

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

```bash
flashdata auth login --replace
flashdata auth status
```


<a id="revoke"></a>

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

- [API Keys](https://flashdata.dev/app/api-keys)
- [Connected apps](https://flashdata.dev/app/settings/connections)
- [Resolução de problemas de autenticação](https://flashdata.dev/pt/docs/guides/headers-and-authentication/reference.md#errors)
