تخطَّ إلى المحتوى
AR
الحصول على مفتاح API
تصفح الوثائق

عمليات التكامل

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

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

في هذه الصفحة

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

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

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

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

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

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

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

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

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

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

استيراد مرة واحدة
flashdata auth login --profile research

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

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

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

تخطي إذا تم تشكيله بالفعل
# 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
(
: "${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'
)

اقرأ 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

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

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

حقول توضيحية
{
  "accountType": "temporary",
  "access": "ready",
  "installed": false,
  "recurringAllowed": false,
  "scopes": [
    "google_search"
  ]
}

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

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

خواديم قائمة
codex mcp list

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

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

افحص الخادم
openclaw mcp doctor flashdata --probe

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

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

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

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

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

:: التحقق من إمكانية الوصول إلى العمليات الجديدة؛ 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}'
)

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

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

Revoke access

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

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

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

النتيجةالإجراء
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 قبل العمل المدفوع الأجر؛ لا تحل محل مفتاح صالح.