# Pengepala dan otentikasi

Gunakan hos dan bukti kelayakan yang betul, kemudian sahkan akses dengan satu permintaan percuma.

Referensi boonical: https://flashdata.dev/ms/docs/guides/headers-and-authentication
Diulas: 2026-11-04 oleh FlashData

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

## Pangkalan URLs

| Tujuan | Pangkalan URL | Pengesahan |
| --- | --- | --- |
| Pertanyaan dan pekerjaan data | https://data.flashdata.dev/v1 | X-API-Key |
| Identitas, keseimbangan, harga, batas dan penggunaan | https://api.flashdata.dev/v2 | X-API-Key |
| Remote MCP | https://data.flashdata.dev/mcp | OAuth, atau X-API-Key |


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

## Pemetaan otentikasi berikut

Permintaan RUST OREST menggunakan X-API-Key dengan kunci pengadilan atau pemilik. Kirim badan JSON dengan Content-Type: application/json. CLI Profil-profile, SDK lingkungan dan MCP koneksi Neavidential stor kelayakan secara terpisah.

### Kunci EST / API

#### headers permintaan ORANG

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


### MCP / OAuth

Biarkan MCP mendapatkan tuan rumah, menyimpan dan segarkan kembali token ini melalui log masuk. Gunakan di titik akhir MCP. Host menggunakan kunci API sebagai gantinya mengirim X-API-Key.

#### Pengepala diurus oleh tuan rumah MCP

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [Dapatkan kunci API](https://flashdata.dev/ms/docs/guides/api-keys-and-permissions/reference.md)
- [Sambung melalui MCP](https://flashdata.dev/ms/docs/integrations/mcp-clients/reference.md)

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

## Tentukan kunci anda

Jalankan ini di terminal Anda. Identitas identitas titik akhir memeriksa akses tanpa menghabiskan kredit. Skip key prompt jika FLASHDATA_API_KEY sudah ditetapkan.

### Bash / cURL

Kemudia membutuhkan Bash dan cURL 7.76+. Skip key propt tersembunyi jika lingkungan Anda sudah memasok FLASHDATA_API_KEY. Jalankan perintah baca di terminal yang sama.

#### Tetapkan kata kunci · skip jika sudah dikonfigurasi

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

#### akun baca 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

Skip key prompt tersembunyi jika FLASHDATA_API_KEY sudah ditetapkan. Jalankan perintah baca di terminal yang sama.

#### Tetapkan kata kunci · skip jika sudah dikonfigurasi

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

#### akun baca 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>

### Tanggapan yang diharap

HTTP 200. Periksa akun yang dituju, access: ready dan sumber Anda dalam lingkup. Kunci sementara A A NEGERI mempunyai accountType: temporary; pekerjaan pemilik yang berulang memerlukan recurringAllowed: true.

#### Identitas Pemilik Outsocution · kutipan respon ilustrasi

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

- [Buat panggilan API pertama anda](https://flashdata.dev/ms/docs/guides/http-quickstart/reference.md#curl)

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

## Penyimpanan ditandatangani oleh URLs

Otorisasi mereka sendiri termasuk hasil dari URLs. Ikuti URL yang dikembalikan tanpa X-API-Key, token OAuth atau biskut browser.


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

## Pencarisilapan Penerus:

| Respons | Langkah selanjutnya |
| --- | --- |
| 401 | Periksa kunci di lingkungan ini, kedaluwarsa dan pembatalannya. Use a current API, not an MCP token atau a bear prefix. |
| 403 / sumber hilang | Tanya pemilik untuk memberikan sumber yang diperlukan ke kunci ini. |
| 503 Pada bacaan gratis ini | Coba baca lagi nanti. Status akun tidak diverifikasi; jangan menyimpulkan bahwa pertanyaan yang telah dibayar telah siap. |

