تصفح الوثائق
عمليات التكامل
اتصل باستخدام مفتاح API أو MCP OAuth، وتحقق من الوصول دون استعلام مدفوع، ثم أعد استخدامه للمهام اللاحقة.
في هذه الصفحة
1. الاختيار والربط
متصل بالفعل؟ إذهب مباشرة إلى الشيك الحر في الخطوة 2. وإلا، اختيار الوصول إلى تطبيقك أو يحتاج وكيل.
| أنتِ متصله | الاستخدام | من يحافظ على الإبداع؟ |
|---|---|---|
| An app, SDK, CLI or scheduled script | مفتاح شركة API | متجر الخادم الخاص بك أو ملف CLI |
| Codex أو OpenClaw | MCP OAuth | (المضيف بعد موافقة (بروسر |
| عميل يُحاولُ FlashData بدون حساب | مفتاح API المؤقت | العميل انقذ ملف التجربة، ثمّ وصول المالك بعد الإدعاء |
إنشاء مفتاح في API Keys مع المصادر التي تحتاج إليها مهمتك، أو إعادة استخدام مفتاح قائم. تمدّنه لك SDK أو إرسالها X-API-Key من مساندتك وتُجرى عمليات التحقق من الـ Bash و PowerShell في الخطوة 2 مباشرة مع شركة API؛ ولا يلزم إنشاء أي منشأة من طراز CLI.
استخدم مضيفًا معدًّا لـ FlashData OAuth. يُكمل مالك الحساب التسجيل أو تسجيل الدخول والموافقة في المتصفح؛ ويحفظ المضيف الرموز. لا يثبّت هذا الاتصال مفتاح CLI ولا يربط وصولًا تجريبيًا بالحساب.
URL: https://data.flashdata.dev/mcp
Transport: Streamable HTTP
Authentication: OAuth
Scope: mcp:researchللوكيل الذي لا يملك مفتاحًا، اكتشف أهلية التجربة الحالية قبل التسجيل. أعد استخدام تجربة موجودة وملفها الشخصي. يتطلب YouTube Download والمهام المتكررة وصول المالك.
flashdata discover --profile research --jsonأي مصادر يمكن أن تستخدم هذا الإبداع؟
استخدم 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 |
وفّر مفتاحا في CLI
Skip import if the CLI لديه بالفعل الوصول أو لوازم مديرك السري FLASHDATA_API_KEY. وإلا، اختر طريقة ما دون ذلك، واحتفظ بنفس مواصفات البحث في الأوامر اللاحقة. ولا يتوفر تلقائياً مفتاح CLI لـ SDKs أو خواديم محلية من طراز MCP.
استلم المفتاح في محطة الخفاء السريع
flashdata auth login --profile researchوضع FLASHDATA_KEY_FILE إلى طريق ملف أساسي محمي قائم. وتقرأه القيادة من خلال stdin؛ وتبقي المفتاح بعيدا عن الدردشة وحجج القيادة.
: "${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"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(
: "${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'
)قفزة المفتاح المخفي إذا FLASHDATA_API_KEY تم تحديده بالفعل. أديروا أوامر القراءة في نفس المحطة
# 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& {
$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
}استخدم مستخدم نظام التشغيل والملف الشخصي ودليل الحالة المستخدمين عند تسجيل الدخول. استبدل research إذا كنت تستخدم ملفًا شخصيًا آخر؛ وأضف --state-dir PATH عند الحاجة. يتجاوز FLASHDATA_API_KEY المفتاح المحفوظ. توقّع ok: true وdata.accessVerified: true؛ ثم افحص حقول الهوية أدناه.
flashdata auth status --profile research --json --non-interactiveأرسل هذا إلى جلسة جديدة من عميلك المتصل يستعاض عن google_search بالمصدر الذي تحتاج إليه مهمتك. توقع نجاح كل من الأداة؛ التحقق من الأسعار والتوازن بشكل منفصل قبل العمل المدفوع الأجر. الخادم المدرج وحده لا يتحقق من الدخول.
استخدم اتصال flashdata MCP الموجود.
استدعِ get_pricing باستخدام {"source":"google_search","request_count":1}.
استدعِ get_balance باستخدام {}.
أبلغ عما إذا نجح الاستدعاءان، وما إذا كان للمصدر سعر متاح،
وعن الرصيد المتاح. الرصيد الصفري لا يعني فشل المصادقة.
لا تنفّذ بحثًا أو تنزيلًا، ولا تنشئ تجربة، ولا تغيّر بيانات الاعتماد.اقرأ 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 --probe3. إعادة استخدام سبل الوصول إلى المهام اللاحقة
أبقوا متجر الإبداع خاص ومثابرة عبر العمليات اعيدي فحص الدخول في عملية جديدة قبل أن تتمكني من تحديد مواعيدك
| الخلية | للمهمة المقبلة |
|---|---|
| مفتاح شركة API | إعادة استخدام المفتاح المنقذ. وليس لديها أي خطوة من خطوات تجديد OAuth؛ والاستعاضة عنها إذا انتهت صلاحيتها أو ألغيت. |
| MCP OAuth | يجدّد المضيف رموز وصول OAuth ذات الساعة الواحدة باستخدام رموز تجديد متعاقبة. أعد الاتصال عند انتهاء التفويض بعد 90 يومًا أو إلغائه. لكل تثبيت مخزن رموزه الخاص؛ ولا تشارك ملفات رموز التجديد بين المضيفين. |
| مفتاح API المؤقت | أكمل ربط الحساب بالمالك وتسليم بيانات الاعتماد قبل العمل المتكرر. أعد استخدام الملف الشخصي الأصلي؛ ولا تسجّل من جديد لكل تشغيل. |
تحقق من مهمة CLI قبل الجدولة
يتطلب Bash وjq. اضبط SOURCE على مصدر المهمة. يستخدم السكربت research افتراضيًا؛ اضبط FLASHDATA_PROFILE وFLASHDATA_STATE_DIR لملف شخصي أو دليل حالة مختلف. يعني رمز الخروج 0 مع JSON الهوية أن مفتاح المالك جاهز ومثبّت ومسموح لهذا المصدر. أوقف المجدول عند أي رمز خروج آخر. لا يُرسل أي استعلام.
(
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 OAuth | Settings → Connected apps → التفويض الخاص بالتطبيق. |
| وكيل مدعى عليه API | Settings → Connected apps → Agent connections. |
| حساب API | API 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 قبل العمل المدفوع الأجر؛ لا تحل محل مفتاح صالح. |