Saltar al contenido
ES
Obtener clave API
Explorar documentación

Integraciones

Opciones de autenticación para agentes

Conecta con una clave API o MCP OAuth, verifica el acceso sin una consulta de pago y reutilízalo en tareas posteriores.

En esta página

1. Elige cómo conectarte

Si ya tienes acceso, pasa a la comprobación gratuita del paso 2. Si no, elige la opción que necesita tu aplicación o agente.

Qué conectasOpciónQuién guarda la credencial
Una aplicación, SDK, CLI o script programadoClave API del titularEl gestor de secretos de tu servidor o el perfil de la CLI
Herramientas de investigación de Codex u OpenClawMCP OAuthEl cliente, tras la autorización en el navegador
Un agente que prueba FlashData sin una cuentaClave API temporalEl perfil de prueba del agente; tras vincularlo a una cuenta, guarda el acceso del titular

Crea una clave en API Keys con las fuentes que necesita tu tarea, o reutiliza una existente. Pásala al SDK o envíala en X-API-Key desde tu backend. Las comprobaciones de Bash y PowerShell del paso 2 usan la API directamente y no requieren instalar la CLI.

¿Qué fuentes permite la credencial?

Usa X-API-Key en las solicitudes HTTP y en las conexiones MCP con clave API. Los tokens OAuth solo funcionan en el endpoint MCP remoto. YouTube Download requiere una clave API del titular con permiso youtube_download y un destino de almacenamiento.

CredencialFuentes disponibles
Clave API del titularLas fuentes autorizadas en la clave, incluido youtube_download si se ha aprobado.
Clave API temporalSolo las fuentes autorizadas y disponibles en la prueba. Consulta scopes en la respuesta de identidad actual.
MCP OAuthgoogle_search, youtube_search, youtube_metadata, youtube_transcript

Guarda una clave en la CLI

Omite la importación si la CLI ya tiene acceso o tu gestor de secretos proporciona FLASHDATA_API_KEY. Si no, elige un método y conserva el perfil research para los siguientes comandos. Una clave guardada en la CLI no se proporciona automáticamente a los SDK ni a los servidores MCP locales.

Pega la clave cuando la terminal la solicite; la entrada no se muestra en pantalla.

Importar una vez
flashdata auth login --profile research

2. Verifica la conexión

Ejecuta la comprobación gratuita en el entorno donde se realizará la tarea. La CLI y HTTP usan una clave API; MCP usa la conexión guardada del cliente.

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'
)

Comprueba la identidad de la clave API

En la respuesta HTTP, los campos de identidad están en el nivel superior. En el JSON de la CLI, lee data.identity.identity y exige data.accessVerified: true. Un HTTP 200 o un ok: true de la CLI no bastan.

VerificaResultado requerido
Cuenta correctaaccountId y apiKeyId corresponden a la cuenta y la clave que quieres usar.
Acceso listoaccess: ready
Permiso de la tareascopes incluye la fuente, por ejemplo google_search. La CLI también muestra las fuentes permitidas en data.identity.permittedSources.
Tarea periódicaaccountType: owned · installed: true · recurringAllowed: true

Una prueba activa también es una conexión válida

Una prueba puede servir para una tarea puntual aunque recurringAllowed sea false. Revisa los permisos y la fecha de caducidad reales. Vincula la prueba existente a una cuenta antes de programar tareas.

Identidad temporal · ejemplo de campos
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

Localiza la conexión en Codex

Lista los servidores configurados y abre /mcp en una nueva sesión de Codex. Ejecuta la comprobación MCP anterior para verificar la credencial.

Listar servidores
codex mcp list

Comprueba la conexión en OpenClaw

Comprueba el servidor guardado y ejecuta el mensaje de comprobación MCP anterior en tu conversación activa.

Comprobar el servidor
openclaw mcp doctor flashdata --probe

3. Reutiliza el acceso en otras tareas

Guarda las credenciales en un almacén privado que persista al reiniciar el proceso. Comprueba el acceso en un proceso nuevo antes de activar el programador de tareas.

CredencialPara la próxima tarea
Clave API del titularReutiliza la clave guardada. No requiere renovación OAuth; sustitúyela si caduca o se revoca.
MCP OAuthEl cliente renueva los tokens de acceso OAuth, válidos durante una hora, mediante tokens de renovación rotatorios. Vuelve a conectar cuando la autorización de 90 días caduque o se revoque. Cada instalación guarda sus propios tokens; no compartas archivos de tokens de renovación entre clientes.
Clave API temporalCompleta la vinculación a una cuenta y la entrega de la credencial del titular antes de programar tareas. Conserva el perfil original; no te registres de nuevo en cada ejecución.

Comprueba la CLI antes de programar

Requiere Bash y jq. Define SOURCE con la fuente de tu tarea. El perfil predeterminado es research; usa FLASHDATA_PROFILE y FLASHDATA_STATE_DIR para cambiar el perfil o directorio. Un código 0 con JSON de identidad confirma que la clave del titular está lista, instalada y autorizada para esa fuente. El programador debe detenerse ante cualquier otro código de salida. No se envían consultas.

Comprobar el acceso en un proceso nuevo · Bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)

Si aún usas una prueba

Sigue la guía de prueba y vinculación con el perfil original. Tras la aprobación del titular y la entrega de la credencial, la comprobación gratuita debe mostrar acceso owned y recurringAllowed: true. Las siguientes solicitudes usan el saldo compartido del titular; los créditos de prueba sin usar no se transfieren. Iniciar sesión con MCP OAuth crea una conexión independiente y no vincula esta prueba.

Revoca el acceso

Pausa primero las tareas recurrentes. Revoca la credencial correspondiente y repite la comprobación gratuita en un proceso o sesión nuevos antes de borrar el acceso local. La autenticación debe fallar o pedir que vuelvas a conectar; no autorices otra conexión durante la comprobación. Cerrar la sesión local no revoca el acceso en el servidor.

ConexiónDónde revocarlo
MCP OAuthSettings → Connected apps → la autorización de la aplicación.
Clave de un agente vinculadoSettings → Connected apps → Agent connections.
Clave API de la cuentaAPI Keys → la clave utilizada por esta integración.

Resuelve una comprobación fallida

ResultadoQué hacer
accessVerified: falseConsulta phase y nextCommand. Un perfil pendiente puede devolver ok: true antes de que la clave sea utilizable. Completa el registro o la vinculación pendientes con el mismo perfil.
access: blockedDetén la tarea aunque la respuesta HTTP sea 200. Revisa la cuenta o la conexión en la consola; recibir la identidad no significa que tengas permiso para consultar datos.
accountType: temporaryUsa la prueba para tareas puntuales permitidas. Vincúlala a una cuenta antes de programar tareas; una conexión OAuth nueva no vincula este perfil.
installed: falseTras la aprobación del titular, ejecuta flashdata auth finish --wait con el perfil y el directorio de estado originales. Después, repite la comprobación.
401 / invalid_grantVuelve a conectar la credencial caducada o revocada desde su cliente original. No crees otra prueba para eludir el bloqueo.
403 / source_forbiddenRevisa scopes en la clave o la lista de fuentes de OAuth. YouTube Download usa una clave API del titular.
Acceso válido, saldo ceroLa autenticación funciona. Revisa Billing antes de ejecutar trabajo de pago; conserva la clave válida.