# Headers ve kimlik doğrulama

Doğru sunucu ve kimlik bilgilerini kullanın, ardından ücretsiz bir istekle erişimi doğrulayın.

Canonical referans: https://flashdata.dev/tr/docs/guides/headers-and-authentication
İnceleme: 2026-11-04 Tarafından FlashData

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

## Base URLs

| Amaç | Base URL | Kimlik doğrulama |
| --- | --- | --- |
| Veri sorguları ve işleri | https://data.flashdata.dev/v1 | X-API-Key |
| Kimlik, denge, fiyatlandırma, limitler ve kullanım | https://api.flashdata.dev/v2 | X-API-Key |
| Uzak MCP | https://data.flashdata.dev/mcp | Host-managed OAuth veya X-API-Key |


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

## Kimlik Başlıkları

REST talepleri X-API-Key'u bir deneme veya sahibi anahtarla kullanır. Send Send Gönder JSON Vücutlarla bedenler Content-Type: application/json. CLI Profiller, profiller SDK ortamları ve ortamlar MCP Bağlantılar ayrı ayrı ayrı olarak depo bilgilerini dağıtır.

### REST / API anahtarı

#### Başlıklar İstek

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


### MCP / OAuth

MCP ev sahibi elde edin, mağazayı açın ve bu token'i giriş yoluyla yenilemeye izin verin. Sadece MCP uç noktasında kullanın. API anahtarını kullanarak ev sahibi X-API-Key gönderir.

#### Header MCP host tarafından yönetilen

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [API anahtarı alın](https://flashdata.dev/tr/docs/guides/api-keys-and-permissions/reference.md)
- [Connect through through MCP](https://flashdata.dev/tr/docs/integrations/mcp-clients/reference.md)

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

## Anahtarınızı doğrulayın

Bunu terminalinizde çalıştırın. Kimlik uç noktası kredi harcamadan erişim kontrol eder. FLASHDATA_API_KEY'un zaten ayarlandığı anahtara gelin.

### Bash / cURL

Bash ve cURL 7.76+'yı gerektirir. Çevrenizin zaten FLASHDATA_API_KEY'u tedarik etmesi durumunda gizli anahtarı yazın. Aynı terminaldeki okuma komutlarını çalıştırın.

#### Anahtarı ayarlayın · zaten yapılandırılırsa atlayın

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

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

FLASHDATA_API_KEY'un zaten ayarlandığı gizli anahtara girin. Aynı terminaldeki okuma komutlarını çalıştırın.

#### Anahtarı ayarlayın · zaten yapılandırılırsa atlayın

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

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

### Beklenmiş yanıt

HTTP 200'u bekleyin. Planlanan hesabı kontrol edin, access: ready ve kaynaklarınızı kapsamakta. Geçici bir anahtar accountType: temporary; tekrarlanan sahibi iş recurringAllowed: true gerektirir.

#### Sahip kimliği · illüstrasyonel yanıt alıntı

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

- [İlk API çağrınızı yapın](https://flashdata.dev/tr/docs/guides/http-quickstart/reference.md#curl)

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

## İmzalanan depolama URLs

Sonuç ve URLs'u yükleme kendi yetkilerini içerir. URL olmadan geri döndü X-API-Key, OAuth tokens veya tarayıcı kurabiyeleri.


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

## Problemleme doğrulama

| Yanıt | Sonraki adım |
| --- | --- |
| 401 | Bu ortamda anahtarı kontrol edin, onun expiry ve revokasyon. Mevcut bir API anahtarı kullanın, bir MCP token veya bir Bearer önfix değil. |
| 403 / kaynak eksik | Sahibine bu anahtara gerekli kaynağı vermelerini isteyin. |
| 503 bu ücretsiz okumada | Okumayı daha sonra yeniden deneyin. Hesap durumu doğrulanmadı; ücretli bir sorgunun hazır olduğunu unutmayın. |

