Salta al contenuto
IT
Ottieni la chiave API
Sfoglia la documentazione

Per iniziare

Intestazioni e autenticazione

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

In questa pagina

Base URLs

OggettoBase URLAutenticazione
Domande e lavori sui datihttps://data.flashdata.dev/v1X-API-Key
Identità, equilibrio, prezzi, limiti e utilizzohttps://api.flashdata.dev/v2X-API-Key
MCP remotohttps://data.flashdata.dev/mcpOAuth, o X-API-Key

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.

Richiesta intestazioni
X-API-Key: fd_YOUR_API_KEY
Content-Type: application/json

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.

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: 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
(
: "${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'
)

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
{
  "accountId": "acc_example",
  "apiKeyId": "key_example",
  "accountType": "owned",
  "access": "ready",
  "scopes": [
    "google_search"
  ],
  "recurringAllowed": true
}

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.

Risoluzione dei problemi di autenticazione

RispostaProssimo passo
401Controllare 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 mancanteChiedi al proprietario di concedere la fonte richiesta a questa chiave.
503 su questa lettura gratuitaRiprovare il letto più tardi. Lo stato dell'account non è stato verificato; non dedurre che una domanda a pagamento è pronta.