Saltar al contenido
ES
Obtener clave API
Explorar documentación

Primeros pasos

Cabeceras y autentificación

Usa el servidor y la credencial adecuados y verifica el acceso con una solicitud gratuita.

En esta página

Base URLs

PropósitoBase URLAutenticación
Consultas de datos y empleoshttps://data.flashdata.dev/v1X-API-Key
Identidad, equilibrio, precios, límites y usohttps://api.flashdata.dev/v2X-API-Key
Remoto MCPhttps://data.flashdata.dev/mcpOAuth gestionado por el anfitrión, o X-API-Key

Cabeceras de autenticación

Las solicitudes REST utilizan X-API-Key con una clave de prueba o del titular. Envía cuerpos JSON con Content-Type: application/json. Los perfiles de la CLI, los entornos del SDK y las conexiones MCP guardan las credenciales por separado.

Solicitud de encabezados
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json

Verifique su llave

Ejecute esto en su terminal. El punto final de identidad verifica el acceso sin créditos de gasto. Saltar el aviso clave si FLASHDATA_API_KEY ya está establecido.

Requiere Bash y cURL 7.76+. Si FLASHDATA_API_KEY ya está definida en tu entorno, omite el paso para introducirla. Ejecuta los comandos en la misma terminal.

Define la clave si aún no está configurada
# 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
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'
)

Respuesta esperada

Espere HTTP 200. Compruebe la cuenta prevista, access: ready y su fuente en los ámbitos. Una clave temporal tiene accountType: temporary; el trabajo del propietario recurrente requiere recurringAllowed: cierto.

Identidad del propietario · extracto de respuesta ilustrativa
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}

Almacenamiento firmado URLs

Resultado y carga URLs incluyen su propia autorización. Siga las fichas URL devueltas sin X-API-Key, OAuth o cookies del navegador.

Solución de problemas de autenticación

RespuestaSiguiente paso
401Revise la clave en este entorno, su expiración y revocación. Utilice una tecla API actual, no una ficha MCP o un prefijo Bearer.
403 / fuente desaparecidaPida al propietario que conceda la fuente requerida a esta clave.
503 en esta lectura gratuitaRegresar la lectura más tarde. No se verificó el estado de cuenta; no infiere que una consulta pagada está lista.