# Berichtkoppen en authenticatie

Gebruik de juiste host en inloggegevens en controleer de toegang met één gratis verzoek.

Canonische referentie: https://flashdata.dev/nl/docs/guides/headers-and-authentication
Beoordeeld: 2026-11-04 door FlashData

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

## Basis URLs

| Betreft | Basis URL | Authenticatie |
| --- | --- | --- |
| Gegevensvragen en -taken | https://data.flashdata.dev/v1 | X-API-Key |
| Identiteit, evenwicht, prijsstelling, limieten en gebruik | https://api.flashdata.dev/v2 | X-API-Key |
| MCP op afstand | https://data.flashdata.dev/mcp | Host beheerd OAuth, of X-API-Key |


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

## Authenticatiekoppen

REST-verzoeken gebruiken X-API-Key met een trial- of eigenaarsleutel. JSON-lichamen verzenden met Content-Type: application/json. CLI profielen, SDK omgevingen en MCP verbindingen slaan referenties apart op.

### REST / API sleutel

#### Berichtkoppen aanvragen

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


### MCP / OAuth

Laat de MCP-host deze token verkrijgen, opslaan en vernieuwen door inloggen. Gebruik het alleen bij het MCP eindpunt. Hosts met behulp van een API sleutel in plaats daarvan X-API-Key sturen.

#### Header beheerd door de MCP host

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Een API-sleutel aanmaken](https://flashdata.dev/nl/docs/guides/api-keys-and-permissions/reference.md)
- [Verbinden via MCP](https://flashdata.dev/nl/docs/integrations/mcp-clients/reference.md)

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

## Controleer uw sleutel

Voer dit uit in je terminal. Het identiteitseindpunt controleert de toegang zonder kredieten uit te geven. Skip the key prompt als FLASHDATA_API_KEY al is ingesteld.

### Bash / cURL

Vereist Bash en cURL 7.76+. Sla de verborgen sleutelprompt over als uw omgeving al FLASHDATA_API_KEY levert. Voer de leesopdrachten uit in dezelfde terminal.

#### De sleutel instellen · overslaan indien reeds ingesteld

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

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

Sla de verborgen sleutelprompt over als FLASHDATA_API_KEY al is ingesteld. Voer de leesopdrachten uit in dezelfde terminal.

#### De sleutel instellen · overslaan indien reeds ingesteld

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

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

### Verwacht antwoord

Verwacht HTTP 200. Controleer de beoogde account, access: ready en uw broncode in scopes. Een tijdelijke sleutel heeft accountType: temporary; terugkerende eigenaar werk vereist recurringAllowed: true.

#### Identiteit van de eigenaar · illustratieve reactie fragment

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

- [Je eerste API-aanroep uitvoeren](https://flashdata.dev/nl/docs/guides/http-quickstart/reference.md#curl)

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

## Ondertekende opslag URLs

Resultaat en upload URLs bevatten hun eigen autorisatie. Volg de geretourneerde URL zonder X-API-Key, OAuth tokens of browser cookies.


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

## Probleemoplossingscontrole

| Antwoord | Volgende stap |
| --- | --- |
| 401 | Controleer de sleutel in deze omgeving, de vervaldatum en intrekking. Gebruik een huidige API sleutel, geen MCP token of een Bearer prefix. |
| 403 / bron ontbreekt | Vraag de eigenaar om de vereiste bron aan deze sleutel toe te kennen. |
| 503 op deze gratis gelezen | Probeer de lezing later nog eens. De status van de rekening is niet geverifieerd; laat niet merken dat een betaalde query klaar is. |

