# Header und Authentifizierung

Verwenden Sie den richtigen Host und Zugangsnachweis und prüfen Sie den Zugriff mit einer kostenlosen Anfrage.

Kanonische Referenz: https://flashdata.dev/de/docs/guides/headers-and-authentication
Test: 2026-11-04 von FlashData

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

## Basis URLs

| Zweck | Basis URL | Authentifizierung |
| --- | --- | --- |
| Datenanfragen und Jobs | https://data.flashdata.dev/v1 | X-API-Key |
| Identität, Saldo, Preis, Limits und Nutzung | https://api.flashdata.dev/v2 | X-API-Key |
| Fernbedienung MCP | https://data.flashdata.dev/mcp | Host-managed OAuth oder X-API-Key |


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

## Authentifizierungs-Header

REST-Anfragen verwenden X-API-Key mit einem Test- oder Besitzerschlüssel. Senden Sie JSON-Körper mit Content-Type: application/json. CLI-Profile, SDK-Umgebungen und MCP-Verbindungen speichern Anmeldeinformationen separat.

### REST / API Schlüssel

#### Request Headers (Anfrage-Header)

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


### MCP / OAuth

Lassen Sie den MCP-Host dieses Token durch Login erhalten, speichern und aktualisieren. Verwenden Sie es nur am MCP-Endpunkt. Hosts, die einen API-Schlüssel verwenden, senden stattdessen X-API-Key.

#### Header verwaltet durch den MCP-Host

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [API-Schlüssel erstellen](https://flashdata.dev/de/docs/guides/api-keys-and-permissions/reference.md)
- [Verbindung über MCP](https://flashdata.dev/de/docs/integrations/mcp-clients/reference.md)

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

## Überprüfen Sie Ihren Schlüssel

Führen Sie dies in Ihrem Terminal aus. Der Identitätsendpunkt überprüft den Zugriff, ohne Credits auszugeben. Überspringen Sie die Tastenaufforderung, wenn FLASHDATA_API_KEY bereits eingestellt ist.

### Bash / cURL

Erfordert Bash und cURL 7.76+. Überspringen Sie die versteckte Tastenaufforderung, wenn Ihre Umgebung bereits FLASHDATA_API_KEY bereitstellt. Führen Sie die Lesebefehle im selben Terminal aus.

#### Schlüssel einstellen · Überspringen, wenn bereits konfiguriert

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

#### Lesen Sie das Konto 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

Überspringen Sie die versteckte Tastenaufforderung, wenn FLASHDATA_API_KEY bereits eingestellt ist. Führen Sie die Lesebefehle im selben Terminal aus.

#### Schlüssel einstellen · Überspringen, wenn bereits konfiguriert

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

#### Lesen Sie das Konto 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>

### Erwartete Antwort

Erwarten Sie HTTP 200. Überprüfen Sie das beabsichtigte Konto, access: ready und Ihre Quelle in Scopes. Ein temporärer Schlüssel hat accountType: temporary; wiederkehrende Besitzerarbeit erfordert recurringAllowed: true.

#### Eigentümeridentität · illustrative Antwort Auszug

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

- [Ersten API-Aufruf ausführen](https://flashdata.dev/de/docs/guides/http-quickstart/reference.md#curl)

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

## Signierter Speicher URLs

Ergebnis und Upload URLs enthalten ihre eigene Autorisierung. Folgen Sie dem zurückgegebenen URL ohne X-API-Key, OAuth Token oder Browser-Cookies.


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

## Authentifizierung von Fehlerbehebungen

| Antwort | Nächster Schritt |
| --- | --- |
| 401 | Überprüfen Sie den Schlüssel in dieser Umgebung, seinen Ablauf und Widerruf. Verwenden Sie einen aktuellen API-Schlüssel, nicht ein MCP-Token oder ein Bearer-Präfix. |
| 403 / Quelle fehlt | Bitten Sie den Besitzer, die erforderliche Quelle für diesen Schlüssel zu gewähren. |
| 503 auf diesem kostenlosen Lesen | Versuchen Sie das Lesen später. Der Kontostatus wurde nicht verifiziert; folgern Sie nicht, dass eine bezahlte Abfrage bereit ist. |

