# الرفات والتوثيق

استخدم المضيف وبيانات الاعتماد الصحيحين، ثم تحقّق من الوصول بطلب مجاني واحد.

مرجع كانوني: https://flashdata.dev/ar/docs/guides/headers-and-authentication
Reviewed: 2026-11-04 by FlashData

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

## قاعدة URLs

| الغرض | قاعدة URL | المصادقة |
| --- | --- | --- |
| الاستفسارات عن البيانات والوظائف | https://data.flashdata.dev/v1 | X-API-Key |
| الهوية، والتوازن، والتسعير، والحدود، والاستخدام | https://api.flashdata.dev/v2 | X-API-Key |
| Remote MCP | https://data.flashdata.dev/mcp | OAuth أو X-API-Key |


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

## مرشدو التوثيق

وتستخدم طلبات شركة REST X-API-Key مع مُحاكمة أو مفتاح مالك. إرسال أجهزة JSON مع Content-Type: application/json. CLI profiles, SDK environments and MCP connections store accreditation separately.

### REST/ API key

#### عدد من رؤساء الطلبات

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


### MCP / OAuth

دعوا MCP المضيف يحصل على هذا المكسور من خلال الشعار استخدمه فقط في MCP نقطة النهاية. ويستخدم المضيفون مفتاح API بدلا من ذلك يرسلون X-API-Key.

#### Header managed by the MCP host

```http
Authorization: Bearer YOUR_MCP_ACCESS_TOKEN
```


- [احصل على مفتاح API](https://flashdata.dev/ar/docs/guides/api-keys-and-permissions/reference.md)
- [Connect through MCP](https://flashdata.dev/ar/docs/integrations/mcp-clients/reference.md)

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

## تحقق من مفتاحك

أديري هذا في محطتك نقطة نهاية الهوية تدقق في الدخول دون أن تُصرف الائتمانات. اضغط على المفتاح إذا FLASHDATA_API_KEY تم تحديده بالفعل.

### Bash / cURL

Requires Bash and cURL 7.76+. تزلج على المفتاح المخفي إذا كانت البيئة الخاصة بك بالفعل إمدادات FLASHDATA_API_KEY. أديروا أوامر القراءة في نفس المحطة

#### تخطي إذا تم تشكيله بالفعل

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

#### الحساب الجاهز 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 تم تحديده بالفعل. أديروا أوامر القراءة في نفس المحطة

#### تخطي إذا تم تشكيله بالفعل

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

#### الحساب الجاهز 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>

### الاستجابة المتوقعة

يتوقع HTTP 200. تحقق من الحساب المقصود access: ready ومصدرك في نطاقات وهناك مفتاح مؤقت يحتوي على accountType: temporary؛ ويستلزم العمل المتجدد للمالكين أن يعاد تشغيله recurringAllowed: true.

#### مقتطفات توضيحية

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

- [نفّذ أول استدعاء API](https://flashdata.dev/ar/docs/guides/http-quickstart/reference.md#curl)

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

## مخزن موقع URLs

وتشتمل النتيجة والشحنة URLs على إذن خاص بها. إتبعوا المُعادون URL بدون X-API-Key, OAuth كُن أو بسكويت مُصفّح.


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

## التوثيق المسبب للمشاكل

| استجابة | الخطوة التالية |
| --- | --- |
| 401 | تحقق من المفتاح في هذه البيئة، وقضيته وإلغاءه. استخدمي مفتاحاً حالياً من طراز API، وليس من طراز MCP أو من طراز Bearer prefix. |
| 403/ source missing | أطلب من المالك أن يمنح المصدر المطلوب لهذا المفتاح |
| 503 على هذا القراء الحر | أعد القراءة لاحقاً ولم يتم التحقق من وضع الحساب؛ ولا تستنتج أن هناك استفساراً مدفوعاً جاهزاً. |

