# Cabeceras y autentificación

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

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

<a id="requests"></a>

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


<a id="choose"></a>

## 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.

### llave REST / API

#### Solicitud de encabezados

```http
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json
```


### MCP / OAuth

Deja 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.

#### Header gestionado por el host MCP

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Obtén una clave API](https://flashdata.dev/es/docs/guides/api-keys-and-permissions/reference.md)
- [Conectar a través de MCP](https://flashdata.dev/es/docs/integrations/mcp-clients/reference.md)

<a id="check"></a>

## 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.

### Bash / cURL

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

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

Si FLASHDATA_API_KEY ya está definida, omite el paso para introducirla. Ejecuta los comandos en la misma terminal.

#### Define la clave si aún no está configurada

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

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



<a id="result"></a>

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

```json
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}
```

- [Haga su primera llamada API](https://flashdata.dev/es/docs/guides/http-quickstart/reference.md#curl)

<a id="storage"></a>

## 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.


<a id="errors"></a>

## 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. |

