# Intestazioni e autenticazione

Usa host e credenziali corretti, poi verifica l’accesso con una richiesta gratuita.

Riferimento canonico: https://flashdata.dev/it/docs/guides/headers-and-authentication
Recensito: 2026-11-04 da FlashData

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

## Base URLs

| Oggetto | Base URL | Autenticazione |
| --- | --- | --- |
| Domande e lavori sui dati | https://data.flashdata.dev/v1 | X-API-Key |
| Identità, equilibrio, prezzi, limiti e utilizzo | https://api.flashdata.dev/v2 | X-API-Key |
| MCP remoto | https://data.flashdata.dev/mcp | OAuth, o X-API-Key |


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

## Intestazioni di autenticazione

Le richieste REST utilizzano X-API-Key con una chiave di prova o di proprietario. Invia corpi JSON con Content-Type: application/json. I profili CLI, gli ambienti SDK e le credenziali di archiviazione delle connessioni MCP separatamente.

### REST / API chiave

#### Richiesta intestazioni

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


### MCP / OAuth

Lascia che l'host MCP ottenga, memorizzi e rinfreschi questo token attraverso il login. Usalo solo al punto finale MCP. Gli host che utilizzano una chiave API invece inviano X-API-Key.

#### Header gestito dall'host MCP

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Ottieni una chiave API](https://flashdata.dev/it/docs/guides/api-keys-and-permissions/reference.md)
- [Collegamento tramite MCP](https://flashdata.dev/it/docs/integrations/mcp-clients/reference.md)

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

## Verifica la tua chiave

Mettilo nel tuo terminale. L'identità endpoint controlla l'accesso senza spendere crediti. Salta il prompt dei tasti se FLASHDATA_API_KEY è già impostato.

### Bash / cURL

Richiede Bash e cURL 7.76+. Salta il prompt dei tasti nascosti se il tuo ambiente già fornisce FLASHDATA_API_KEY. Eseguire i comandi di lettura nello stesso terminale.

#### Impostare la chiave · saltare se già configurato

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

#### Leggi l'account JSON

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

Salta il prompt dei tasti nascosti se FLASHDATA_API_KEY è già impostato. Eseguire i comandi di lettura nello stesso terminale.

#### Impostare la chiave · saltare se già configurato

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

#### Leggi l'account JSON

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

### Risposta prevista

Aspettatevi HTTP 200. Controllare l'account previsto, access: ready e la fonte negli ambiti. Una chiave temporanea ha accountType: temporary; il lavoro del proprietario ricorrente richiede recurringAllowed: true.

#### Identità del proprietario · risposta illustrativa

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

- [Fai la tua prima chiamata API](https://flashdata.dev/it/docs/guides/http-quickstart/reference.md#curl)

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

## Archiviazione firmata URLs

Risultato e upload URLs includono la loro autorizzazione. Seguire i token URL restituiti senza X-API-Key, token OAuth o cookie del browser.


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

## Risoluzione dei problemi di autenticazione

| Risposta | Prossimo passo |
| --- | --- |
| 401 | Controllare la chiave in questo ambiente, la sua scadenza e la revoca. Utilizzare una chiave API corrente, non un token MCP o un prefisso Bearer. |
| 403 / sorgente mancante | Chiedi al proprietario di concedere la fonte richiesta a questa chiave. |
| 503 su questa lettura gratuita | Riprovare il letto più tardi. Lo stato dell'account non è stato verificato; non dedurre che una domanda a pagamento è pronta. |

