Explorar documentación
Primeros pasos
Usa el servidor y la credencial adecuados y verifica el acceso con una solicitud gratuita.
En esta página
Base URLs
| Propósito | Base URL | Autenticación |
|---|---|---|
| Consultas de datos y empleos | https://data.flashdata.dev/v1 | X-API-Key |
| Identidad, equilibrio, precios, límites y uso | https://api.flashdata.dev/v2 | X-API-Key |
| Remoto MCP | https://data.flashdata.dev/mcp | OAuth 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.
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/jsonDeja que el MCP host obtener, almacenar y refrescar este token a través de login. Úsalo sólo en el MCP endpoint. Hosts utilizando un API llave en lugar de enviar X-API-Key.
Authorization: Bearer YOUR_MCP_ACCESS_TOKENVerifique 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.
# 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(
: "${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'
)Si FLASHDATA_API_KEY ya está definida, omite el paso para introducirla. Ejecuta los comandos en la misma terminal.
# 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& {
$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
}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.
{
"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
| Respuesta | Siguiente paso |
|---|---|
| 401 | Revise 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 desaparecida | Pida al propietario que conceda la fuente requerida a esta clave. |
| 503 en esta lectura gratuita | Regresar la lectura más tarde. No se verificó el estado de cuenta; no infiere que una consulta pagada está lista. |