# خيارات التوثيق الخاصة بالعميل

اتصل باستخدام مفتاح API أو MCP OAuth، وتحقق من الوصول دون استعلام مدفوع، ثم أعد استخدامه للمهام اللاحقة.

مرجع كانوني: https://flashdata.dev/ar/docs/guides/agent-access
Reviewed: 2026-11-05 by FlashData

<a id="access"></a>

## 1. الاختيار والربط

متصل بالفعل؟ إذهب مباشرة إلى الشيك الحر في الخطوة 2. وإلا، اختيار الوصول إلى تطبيقك أو يحتاج وكيل.

| أنتِ متصله | الاستخدام | من يحافظ على الإبداع؟ |
| --- | --- | --- |
| An app, SDK, CLI or scheduled script | مفتاح شركة API | متجر الخادم الخاص بك أو ملف CLI |
| Codex أو OpenClaw | MCP OAuth | (المضيف بعد موافقة (بروسر |
| عميل يُحاولُ FlashData بدون حساب | مفتاح API المؤقت | العميل انقذ ملف التجربة، ثمّ وصول المالك بعد الإدعاء |

### مفتاح API

إنشاء مفتاح في API Keys مع المصادر التي تحتاج إليها مهمتك، أو إعادة استخدام مفتاح قائم. تمدّنه لك SDK أو إرسالها X-API-Key من مساندتك وتُجرى عمليات التحقق من الـ Bash و PowerShell في الخطوة 2 مباشرة مع شركة API؛ ولا يلزم إنشاء أي منشأة من طراز CLI.

- [API Keys](https://flashdata.dev/app/api-keys)
- [وفّر مفتاحا في CLI](https://flashdata.dev/ar/docs/guides/agent-access/reference.md#import-key)
- [SDK and HTTP key setup](https://flashdata.dev/ar/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP OAuth

استخدم مضيفًا معدًّا لـ FlashData OAuth. يُكمل مالك الحساب التسجيل أو تسجيل الدخول والموافقة في المتصفح؛ ويحفظ المضيف الرموز. لا يثبّت هذا الاتصال مفتاح CLI ولا يربط وصولًا تجريبيًا بالحساب.

#### المضيفون MCP الاتصال

```text
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:research
```

- [Connect Codex](https://flashdata.dev/ar/docs/integrations/codex/reference.md#setup)
- [Connect OpenClaw](https://flashdata.dev/ar/docs/integrations/openclaw/reference.md#setup)
- [عملاء آخرون من طراز MCP](https://flashdata.dev/ar/docs/integrations/mcp-clients/reference.md#connect)

### وكيل التجربة

للوكيل الذي لا يملك مفتاحًا، اكتشف أهلية التجربة الحالية قبل التسجيل. أعد استخدام تجربة موجودة وملفها الشخصي. يتطلب YouTube Download والمهام المتكررة وصول المالك.

#### الكشف دون تسجيل

```bash
flashdata discover --profile research --json
```

- [ابدأ التجربة وادعها](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md)
- [بروتوكول التوثيق الخاص بالعميل](https://flashdata.dev/auth.md)


<a id="permissions"></a>

### أي مصادر يمكن أن تستخدم هذا الإبداع؟

استخدم X-API-Key لطلبات HTTP العادية واتصالات MCP بمفتاح API. تعمل رموز OAuth الحاملة فقط عند نقطة MCP المستضافة. يتطلب YouTube Download مفتاح API للمالك بصلاحية youtube_download وتخزينًا للوجهة.

| الخلية | المصادر المتاحة |
| --- | --- |
| مفتاح شركة API | المصادر الممنوحة للمفتاح، بما فيها youtube_download عند الموافقة عليها. |
| مفتاح API المؤقت | فقط منحت مصادر مؤهلة للتجربة اقرأي النطاقات من الاستجابة الحالية للهوية. |
| MCP OAuth | google_search, youtube_search, youtube_metadata, youtube_transcript |


<a id="import-key"></a>

### وفّر مفتاحا في CLI

Skip import if the CLI لديه بالفعل الوصول أو لوازم مديرك السري FLASHDATA_API_KEY. وإلا، اختر طريقة ما دون ذلك، واحتفظ بنفس مواصفات البحث في الأوامر اللاحقة. ولا يتوفر تلقائياً مفتاح CLI لـ SDKs أو خواديم محلية من طراز MCP.

#### محطة طرفية تفاعلية

استلم المفتاح في محطة الخفاء السريع

##### استيراد مرة واحدة

```bash
flashdata auth login --profile research
```


#### Automation · Bash

وضع FLASHDATA_KEY_FILE إلى طريق ملف أساسي محمي قائم. وتقرأه القيادة من خلال stdin؛ وتبقي المفتاح بعيدا عن الدردشة وحجج القيادة.

##### اقرأ سر محمي من خلال stdin

```bash
: "${FLASHDATA_KEY_FILE:?Set the path to your protected API-key file}"
flashdata auth login --profile research --api-key-stdin --non-interactive \
  < "$FLASHDATA_KEY_FILE"
```


- [CLI](https://flashdata.dev/ar/docs/guides/flashdata-cli/reference.md#install)

<a id="verify"></a>

## 2. التحقق من الصلة

إجراء الفحص المجاني في البيئة الذي سيؤدي المهمة. CLI و HTTP الشيكات تستخدم API المفتاح؛ MCP الشيك يستخدم اتصال المضيف المنقذ

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


### CLI

استخدم مستخدم نظام التشغيل والملف الشخصي ودليل الحالة المستخدمين عند تسجيل الدخول. استبدل research إذا كنت تستخدم ملفًا شخصيًا آخر؛ وأضف --state-dir PATH عند الحاجة. يتجاوز FLASHDATA_API_KEY المفتاح المحفوظ. توقّع ok: true وdata.accessVerified: true؛ ثم افحص حقول الهوية أدناه.

#### الحساب الحر يقرأ

```bash
flashdata auth status --profile research --json --non-interactive
```

- [أُنشئ مفتاحاً](https://flashdata.dev/ar/docs/guides/api-keys-and-permissions/reference.md#store)

### MCP

أرسل هذا إلى جلسة جديدة من عميلك المتصل يستعاض عن google_search بالمصدر الذي تحتاج إليه مهمتك. توقع نجاح كل من الأداة؛ التحقق من الأسعار والتوازن بشكل منفصل قبل العمل المدفوع الأجر. الخادم المدرج وحده لا يتحقق من الدخول.

#### التحقق من الارتباط

```text
استخدم اتصال flashdata MCP الموجود.
استدعِ get_pricing باستخدام {"source":"google_search","request_count":1}.
استدعِ get_balance باستخدام {}.
أبلغ عما إذا نجح الاستدعاءان، وما إذا كان للمصدر سعر متاح،
وعن الرصيد المتاح. الرصيد الصفري لا يعني فشل المصادقة.
لا تنفّذ بحثًا أو تنزيلًا، ولا تنشئ تجربة، ولا تغيّر بيانات الاعتماد.
```



<a id="identity-result"></a>

### اقرأ API-هوية جيدة

وميادين الهوية من طراز HTTP هي في أعلى المستويات. In CLI JSON, read data.identity.identity and require data.accessVerified: true. HTTP 200 أو CLI ok: true وحده لا يكفي.

| تحقق | النتيجة المطلوبة |
| --- | --- |
| الحساب المعدَّل | accountId و apiKeyId حددا الحساب والمفتاح الذي قصدت استخدامه. |
| الوصول المتاح | access: ready |
| إذن من البعثة | وتحتوي النطاقات على المصدر، مثل google_search. وتورد شركة CLI أيضاً قائمة بالمصادر المسموح بها في data.identity.permittedSources. |
| المهمة المتكررة | accountType: owned · installed: true · recurringAllowed: true |

- [تمهيد هذه الشيكات قبل الجدولة](https://flashdata.dev/ar/docs/guides/agent-access/reference.md#recurring-check)

<a id="trial-result"></a>

### التجربة الفعلية هي صلة صحيحة

ويمكن لأي تجربة أن تمر بفحص لمهمة واحدة في حين أن recurringAllowed is false. اقرأ النطاقات الفعلية والإنهاء؛ وادعى التجربة القائمة قبل تحديد مواعيد العمل.

#### حقول توضيحية

```json
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}
```


<a id="codex"></a>

### اعثر على الصلة في Codex

قائمة خواديم مجهزة، ثم تستخدم /mcp في دورة جديدة من دورات Codex. اركض MCP تحقق من قبل للتحقق من الإبداع

#### خواديم قائمة

```bash
codex mcp list
```

- [Codex setup and first task](https://flashdata.dev/ar/docs/integrations/codex/reference.md)

<a id="openclaw"></a>

### تحقق من الصلة في OpenClaw

افحصوا الخادم المنقذ ثم اديروا MCP تحقق من أعلى في حديثك النشط.

#### افحص الخادم

```bash
openclaw mcp doctor flashdata --probe
```

- [OpenClaw setup and first task](https://flashdata.dev/ar/docs/integrations/openclaw/reference.md)

<a id="refresh"></a>

## 3. إعادة استخدام سبل الوصول إلى المهام اللاحقة

أبقوا متجر الإبداع خاص ومثابرة عبر العمليات اعيدي فحص الدخول في عملية جديدة قبل أن تتمكني من تحديد مواعيدك

| الخلية | للمهمة المقبلة |
| --- | --- |
| مفتاح شركة API | إعادة استخدام المفتاح المنقذ. وليس لديها أي خطوة من خطوات تجديد OAuth؛ والاستعاضة عنها إذا انتهت صلاحيتها أو ألغيت. |
| MCP OAuth | يجدّد المضيف رموز وصول OAuth ذات الساعة الواحدة باستخدام رموز تجديد متعاقبة. أعد الاتصال عند انتهاء التفويض بعد 90 يومًا أو إلغائه. لكل تثبيت مخزن رموزه الخاص؛ ولا تشارك ملفات رموز التجديد بين المضيفين. |
| مفتاح API المؤقت | أكمل ربط الحساب بالمالك وتسليم بيانات الاعتماد قبل العمل المتكرر. أعد استخدام الملف الشخصي الأصلي؛ ولا تسجّل من جديد لكل تشغيل. |

- [تدفق العمل في المهام المتكررة](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md)

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

### تحقق من مهمة CLI قبل الجدولة

يتطلب Bash وjq. اضبط SOURCE على مصدر المهمة. يستخدم السكربت research افتراضيًا؛ اضبط FLASHDATA_PROFILE وFLASHDATA_STATE_DIR لملف شخصي أو دليل حالة مختلف. يعني رمز الخروج 0 مع JSON الهوية أن مفتاح المالك جاهز ومثبّت ومسموح لهذا المصدر. أوقف المجدول عند أي رمز خروج آخر. لا يُرسل أي استعلام.

#### :: التحقق من إمكانية الوصول إلى العمليات الجديدة؛ Bash

```bash
(
set -euo pipefail
SOURCE=google_search
args=(--profile "${FLASHDATA_PROFILE:-research}" --json --non-interactive)
if [[ -n "${FLASHDATA_STATE_DIR:-}" ]]; then
  args+=(--state-dir "$FLASHDATA_STATE_DIR")
fi

flashdata auth status "${args[@]}" |
  jq -e --arg source "$SOURCE" '
    select(.ok == true and .data.accessVerified == true)
    | .data.identity as $auth
    | $auth.identity
    | select(.accountType == "owned" and .access == "ready"
        and .installed == true and .recurringAllowed == true
        and ((.scopes // []) | index($source) != null)
        and (($auth.permittedSources // []) | index($source) != null))
    | {accountId, apiKeyId, scopes, recurringAllowed, expiresAt}'
)
```

- [يضاف تسعير ورصيد وزبون متكرر](https://flashdata.dev/ar/docs/guides/recurring-tasks/reference.md#prepare)

<a id="claim"></a>

### إذا كان الوصول لا يزال تجربة

أكمل دليل التجربة وربط الحساب باستخدام الملف الشخصي الأصلي. بعد موافقة المالك وتسليم بيانات الاعتماد، ينبغي أن يُظهر الفحص المجاني وصول owned وrecurringAllowed: true. تستخدم الطلبات اللاحقة رصيد المالك المشترك؛ ولا ينتقل الرصيد التجريبي غير المستخدم. تسجيل الدخول عبر MCP OAuth اتصال منفصل ولا يربط هذه التجربة.

- [أوامر التجربة والمطالبة](https://flashdata.dev/ar/docs/guides/agent-onboarding/reference.md)
- [auth.md](https://flashdata.dev/auth.md)

<a id="revoke"></a>

## Revoke access

وقف الوظائف المتكررة أولا. قم بتنقيح الاختراع المطابق أدناه، ثم كرر الشيك الحر من عملية أو دورة جديدة قبل تطهير الوصول المحلي. توقع الفشل في التوثيق أو طلب إعادة الاتصال؛ لا توافق على صلة جديدة أثناء الشيك. الدخول المحلي وحده لا يلغي وصول الخادم

| Connection | إلى أين ألغي |
| --- | --- |
| MCP OAuth | Settings → Connected apps → التفويض الخاص بالتطبيق. |
| وكيل مدعى عليه API | Settings → Connected apps → Agent connections. |
| حساب API | API Keys → المفتاح الذي يستخدمه هذا التكامل. |

- [Connected apps](https://flashdata.dev/app/settings/connections)
- [API Keys](https://flashdata.dev/app/api-keys)
- [أخطاء الدخول المضطربة](https://flashdata.dev/ar/docs/guides/troubleshooting/reference.md#credentials)

<a id="fixes"></a>

## اصلح الشيك الفاشل

| النتيجة | الإجراء |
| --- | --- |
| accessVerified: false | إقرأْ المرحلةَ و nextCommand. ويمكن أن يعيد الملف إلى شركة ok: true قبل استخدام المفتاح. أنهي تسجيلها أو مطالبتها المحتفظ بها؛ وحافظ على نفس الصورة. |
| access: blocked | توقف حتى لو كانت استجابة HTTP هي 200. راجع الحساب أو الاتصال في لوحة التحكم؛ استجابة الهوية لا تمنح بحد ذاتها صلاحية تنفيذ الاستعلامات. |
| accountType: temporary | استخدم التجربة المؤهلة للعمل لمرة واحدة. اربطها بالحساب قبل الجدولة؛ فلا يربط اتصال OAuth جديد هذا الملف الشخصي. |
| installed: false | بعد موافقة المالكِ، أديري (فلالداتا) auth finish --wait مع الملف الأصلي ودليل الولاية ثمّ يكرر الشيك. |
| 401 / invalid_grant | أعد توصيل بيانات الاعتماد المنتهية أو الملغاة في مضيفها الأصلي. لا تبدأ تجربة أخرى لتجاوز ذلك. |
| 403 / source_forbidden | تحقق من نطاقات المفتاح أو OAuth قائمة المصادر YouTube Download يستعمل المالك API المفتاح |
| إمكانية الوصول المثبتة، الرصيد الصفري | لقد نجح التوثيق تحقق Billing قبل العمل المدفوع الأجر؛ لا تحل محل مفتاح صالح. |

- [Billing](https://flashdata.dev/app/billing)
- [إسترجاع إتصال مُقاطع](https://flashdata.dev/ar/docs/guides/agent-recovery/reference.md)
