# Nagłówki i uwierzytelnianie

Użyj właściwego hosta i danych uwierzytelniających, a następnie sprawdź dostęp jednym bezpłatnym żądaniem.

Odniesienie kanoniczne: https://flashdata.dev/pl/docs/guides/headers-and-authentication
Przegląd: 2026-11-04 przez FlashData

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

## Podstawa URLs

| Cel | Podstawa URL | Uwierzytelnianie |
| --- | --- | --- |
| Zapytania o dane i miejsca pracy | https://data.flashdata.dev/v1 | X-API-Key |
| Tożsamość, równowaga, ceny, ograniczenia i wykorzystanie | https://api.flashdata.dev/v2 | X-API-Key |
| Zdalne MCP | https://data.flashdata.dev/mcp | Zarządzanie host- OAuth lub X-API-Key |


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

## Nagłówki uwierzytelniania

Żądania REST używać X-API-Key z kluczem próbnym lub właściciela. Wyślij ciała JSON z Content-Type: application/json. Profile CLI, środowiska SDK i połączenia MCP oddzielnie przechowują referencje.

### Klawisz REST / API

#### Poproś nagłówki

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


### MCP / OAuth

Niech host MCP uzyska, przechowa i odświeży ten token poprzez logowanie. Stosować wyłącznie w punkcie końcowym MCP. Hosts za pomocą klawisza API zamiast wysłać X-API-Key.

#### Nagłówek zarządzany przez hosta MCP

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Uzyskaj klucz API](https://flashdata.dev/pl/docs/guides/api-keys-and-permissions/reference.md)
- [Połącz przez MCP](https://flashdata.dev/pl/docs/integrations/mcp-clients/reference.md)

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

## Sprawdź swój klucz

Sprawdź to w terminalu. Punkt końcowy identyfikacji sprawdza dostęp bez wydawania kredytów. Pomiń sygnał, jeśli FLASHDATA_API_KEY jest już ustawiony.

### Bash / cURL

Wymaga Bash i cURL 7.76 +. Pomiń ukryty sygnał, jeśli Twoje środowisko już dostarcza FLASHDATA_API_KEY. Uruchom polecenia odczytu w tym samym terminalu.

#### Ustaw klucz · skip, jeśli jest już skonfigurowany

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

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

Pomiń ukryty sygnał klawisza, jeśli FLASHDATA_API_KEY jest już ustawiony. Uruchom polecenia odczytu w tym samym terminalu.

#### Ustaw klucz · skip, jeśli jest już skonfigurowany

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

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

### Oczekiwana odpowiedź

Oczekuj HTTP 200. Sprawdź zamierzone konto, access: ready i swoje źródło w skopach. Tymczasowy klucz ma accountType: temporary; powtarzające się prace właściciela wymaga recurringAllowed: true.

#### Tożsamość właściciela · Ilustracyjny fragment odpowiedzi

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

- [Wykonaj pierwsze wywołanie API](https://flashdata.dev/pl/docs/guides/http-quickstart/reference.md#curl)

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

## Składowanie podpisane URLs

Rezultat i przesłać URLs zawiera ich własną autoryzację. Podążaj za zwróconym URL bez X-API-Key, żetonów OAuth lub plików cookie przeglądarki.


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

## Uwierzytelnianie rozwiązywania problemów

| Odpowiedź | Następny krok |
| --- | --- |
| 401 | Sprawdź klucz w tym środowisku, jego wygaśnięcie i cofnięcie. Użyj aktualnego klucza API, a nie symbolu MCP lub przedrostka Berera. |
| Brak 403 / źródło | Poproś właściciela o podanie wymaganego źródła tego klucza. |
| 503 na tej bezpłatnej lekturze | Później pobierz odczyt. Status konta nie został zweryfikowany; nie należy wywnioskować, że płatne zapytanie jest gotowe. |

