# Gestión de claves API

Crea una clave para tu aplicación o agente. Guárdala, comprueba el acceso y gestiona su ciclo de vida.

Referencia canónica: https://flashdata.dev/es/docs/guides/api-keys-and-permissions
Revisado: 2026-11-04 por FlashData

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

## 1. Cree una llave

1. Inicie sesión en su cuenta verificada y abra las teclas API. Reutiliza una clave autorizada si ya tiene una.
2. Escríbelo para la aplicación y el medio ambiente, seleccione una expiración y elija las fuentes que necesita. Seleccione Google Buscar el primer ejemplo de búsqueda.
3. Cree la clave y guárdala a continuación. Dele a los agentes independientes y a las aplicaciones de producción teclas separadas para que pueda revocarlas individualmente.

- [Llaves de API abiertas](https://flashdata.dev/app/api-keys)
- [Pruebe antes de registrarse](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md)

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

## 2. Almacene la llave

Elija la forma en que ejecutará los ejemplos FlashData. API y SDK leer FLASHDATA_API_KEY; el CLI puede guardar la clave en su perfil protegido. En producción, inyecte las credenciales de su tienda secreta.

### Bash · API / SDK

#### Establecer la clave para esta 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

#### Establecer la clave para esta 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

Pruebe la clave en el aviso oculto. Para un perfil llamado, anexa --profile NAME aquí y en comandos posteriores. Un perfil previamente configurado requiere iniciar sesión --replace para reemplazar su clave.

#### Guarda la llave

```bash
flashdata auth login
```

- [Instalación CLI](https://flashdata.dev/es/docs/guides/flashdata-cli/reference.md#install)


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

## 3.

Ejecute el cheque gratuito en el mismo terminal o perfil CLI. Use la pestaña que coincida con cómo guardó la llave.

### Bash / cURL

Reutiliza FLASHDATA_API_KEY desde el check anterior en el mismo terminal.

#### Leer el JSON de la cuenta

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

Reutiliza FLASHDATA_API_KEY desde el check anterior en el mismo terminal.

#### Leer el JSON de la cuenta

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

Utilice su acceso CLI guardado. Para un perfil llamado, anexa --profile NAME a cada comando. Estas lecturas no gastan créditos de consulta.

#### Consultar la cuenta gratis

```bash
flashdata auth status
```

- [Configurar una clave](https://flashdata.dev/es/docs/guides/api-keys-and-permissions/reference.md#store)


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

### Confirme la cuenta y la fuente

HTTP devuelve estos campos directamente. Con CLI JSON, encontrarlos bajo data.identity.identity y también requieren data.accessVerified: verdadero.

| Check | Se prevé |
| --- | --- |
| accountId | La cuenta que posee esta carga de trabajo. |
| access | ready |
| scopes | Incluye google_search para la primera búsqueda. |
| recurringAllowed | verdadero antes del trabajo programado del propietario. |

- [Corre tu primera consulta](https://flashdata.dev/es/docs/guides/http-quickstart/reference.md)
- [Saldo de comprobación y fijación de precios](https://flashdata.dev/es/docs/guides/credits-and-billing/reference.md)

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

### Cómo funcionan los permisos de origen

Una clave sólo puede utilizar sus fuentes otorgadas. La selección de productos está separada de los precios: cada clave en la cuenta gasta del saldo compartido, incluyendo créditos adquiridos. Una clave restringida no tiene su propia tapa de gasto. Los productos futuros requieren una concesión de permiso explícito.

- [Catálogo de permisos del agente](https://flashdata.dev/es/docs/guides/agent-onboarding/reference.md#permissions)

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

## Si una clave está expuesta

1. Revoque la clave expuesta inmediatamente en la página de consola que coincide a continuación, y detenga sus calladores programados.
2. Crear un reemplazo con los permisos necesarios, instalarlo en la tienda secreta de cada llamada y ejecutar la verificación gratuita arriba.
3. Revisión Historia y uso de cuenta para actividad inesperada. Eliminar un secreto de un archivo no lo revoca.

- [Claves API](https://flashdata.dev/app/api-keys)
- [Utilización de la cuenta](https://flashdata.dev/es/docs/guides/usage-and-limits/reference.md#usage)

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

## Girar una tecla

1. Cree un reemplazo con las fuentes requeridas e instálelo en el entorno de destino.
2. Repita la verificación gratuita arriba, luego cambie la aplicación o programador. Actualice cada llamada.
3. Revoque la vieja llave después de que los calladores hayan cambiado. Un secreto actualizado en su computadora portátil no actualiza los servicios desplegados.

### Reemplazar una tecla CLI · pegar al impulso oculto

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


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

## Revoque acceso

Detener los calladores programados, revocar la llave que coincide o la conexión a continuación, luego repetir la verificación gratuita con la antigua credencial. Debe ser rechazada. Cerrar sesión localmente no revoca el acceso al servidor.

| Tipo de acceso | Donde revocar |
| --- | --- |
| tecla API Ordinaria | API Keys |
| Claimed agent key | Settings → Connected apps → Agent connections |
| MCP OAuth Grant | Settings → Connected apps |

- [Claves API](https://flashdata.dev/app/api-keys)
- [Aplicaciones conectadas](https://flashdata.dev/app/settings/connections)
- [Resolución de problemas de autenticación](https://flashdata.dev/es/docs/guides/headers-and-authentication/reference.md#errors)
