Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

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.

En esta página

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.

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.

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

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

Reutiliza FLASHDATA_API_KEY desde el check anterior en el mismo terminal.

Leer el JSON de la cuenta
(
: "${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 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.

CheckSe prevé
accountIdLa cuenta que posee esta carga de trabajo.
accessready
scopesIncluye google_search para la primera búsqueda.
recurringAllowedverdadero antes del trabajo programado del propietario.

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.

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.

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
flashdata auth login --replace
flashdata auth status

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 accesoDonde revocar
tecla API OrdinariaAPI Keys
Claimed agent keySettings → Connected apps → Agent connections
MCP OAuth GrantSettings → Connected apps