تصفح الوثائق
البدء
تحقق من وصولك، اصلح طلب فاشل أو اعثر على جواب عن استخدام FlashData.
في هذه الصفحة
ابدأ بفحص الدخول المجاني
افحص المكان الذي فشلت فيه المهمة استخدام وثائق تفويضها الحالية؛ ولا تقدم هذه الأوامر أي استفسار.
إستعملْ وصولَكَ المنقذَ CLI. من أجل ملف مسمّى، ملحق --profile نيم إلى كل أمر هذه القراءات لا تنفق اياً من الأستفكار
flashdata --version
flashdata doctor --offline
flashdata auth status --jsonإستخدم المهمة الحالية FLASHDATA_API_KEY في نفس المحطة أو الحاوية أو الوظيفة المقررة. Requires cURL 7.76+.
(
: "${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 في نفس المحطة أو الحاوية أو الوظيفة المقررة.
& {
$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
}ما الذي سيتحقق منه؟
يجب أن تتضمن الهوية access: ready ومصدرك داخل scopes. في CLI JSON، توجد الهوية ضمن data.identity.identity؛ ويجب أيضًا أن تكون data.accessVerified: true. نجاح الأمر مع accessVerified: false لا يعني التحقق من الوصول.
من أجل إسم CLI موجز، ملحق --profile NAME الى كل قيادة تحت. احتفظي بالأصل --state-dir و OS مستعمل. FLASHDATA_API_KEY overrides a Save CLI key; ويستخدم مضيفو شركة SDKs و MCP تشكيلتهم الإبداعية الخاصة بهم.
العثور على المشكلة وإصلاحها
افتح الحالة التي تطابق خطأك. استخدم المعرّفات والإيصالات من المهمة الأصلية.
القيادة لم تعثر أو تختفي
إذا غاب الملف التنفيذي، ثبّت إصدار نظام التشغيل والمعالج وأضف دليله إلى PATH. إذا غاب الملف الشخصي، فاستخدم مستخدم النظام ودليل الحالة الأصليين. افحص داخل المجدول أو الحاوية أيضًا.
command -v flashdata
flashdata --version
flashdata doctor --offlineGet-Command flashdata
flashdata --version
flashdata doctor --offline401 / 403: key, scope or expiry
لتستبدل مفتاح المالك المنقذ، وتضع المفتاح المعتمد في العجلة الخفية. وإذا تم تحديد موقع FLASHDATA_API_KEY، يستكمل هذا السر في وقت التشغيل بدلا من ذلك؛ وإنقاذ مفتاح آخر من مفتاح CLI لن يلغيه.
- 401: التحقق من أنه قد انتهى صلاحيته أو ألغيه أو غير صحيح. 403: مقارنة المصدر المطلوب مع نطاقات الهوية
- يستخدم REST وSDKs الترويسة X-API-Key. لا يمكن استبدال مفتاح API برمز MCP OAuth. للوصول المؤقت، استخدم استعادة الربط أدناه.
flashdata auth login --replace
flashdata auth status --jsonتمت الموافقة على المطالبة، لكن العميل ما زال لديه إمكانية الوصول إلى التجربة
أنهي عملية التسليم في نفس ملف CLI الذي أوجد المطالبة. ويكمل المالك التوقيع والتحقق من الرسائل الإلكترونية والموافقة عليها في المصفح؛ CLI يستقبل الإبداع.
flashdata auth finish --wait --timeout 10m
flashdata auth status --jsonنطلب وصلة جديدة للتجربة الحالية، والسماح للمالك بالموافقة، ثم تشغيل auth finish. لا تدير init مرة أخرى.
flashdata auth claim402: عدم كفاية الائتمانات
Compare availableCredits مع السعر الحالي لمصدرك اطالب بتجربة مرهقة لاستعمال رصيد المالك او دع المالك يراجع Billing قبل إعادة التجريب
إستعملْ وصولَكَ المنقذَ CLI. من أجل ملف مسمّى، ملحق --profile نيم إلى كل أمر هذه القراءات لا تنفق اياً من الأستفكار
flashdata account balance
flashdata account pricing --source google_search --request-count 1إستخدم المهمة الحالية FLASHDATA_API_KEY في نفس المحطة أو الحاوية أو الوظيفة المقررة. Requires cURL 7.76+.
(
: "${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/balance' || exit
printf '\n'
curl --fail-with-body --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
'https://api.flashdata.dev/v2/api-access/pricing?source=google_search&request_count=1' || exit
printf '\n'
)إستخدم المهمة الحالية FLASHDATA_API_KEY في نفس المحطة أو الحاوية أو الوظيفة المقررة.
& {
$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/balance"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
$flashdataUri = "$flashdataBase/api-access/pricing?source=google_search&request_count=1"
Invoke-RestMethod -Uri $flashdataUri `
-Headers $flashdataHeaders -TimeoutSec 20 -MaximumRedirection 0 |
ConvertTo-Json -Depth 20
}429: Wait before retrying
اقرأ Retry-After على الرد الفاشل: ثوان أو تاريخ HTTP. انتظر حتى ذلك الحين وقلل من التناسق. ويسمح تسجيل المحاكمات بثلاثة تسجيلات لكل مدخل من طراز IP لكل نافذة من نافذة 24-ساعة؛ وإعادة استخدام الملف الأصلي وإثبات التسجيل.
توضح هذه القراءة المجانية حفظ الترويسات والحالة والجسم. استخدم Retry-After من العملية التي فشلت؛ فقد تختلف حدود الاستعلام والتسجيل وقراءة الحساب.
# Bash + cURL + jq. This is a free account read.
(
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
curl --silent --show-error --max-time 20 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--dump-header diagnostic-headers.txt --output diagnostic.json \
--write-out '%{http_code}\n' \
'https://api.flashdata.dev/v2/api-access/identity' > diagnostic-status.txt || exit
printf 'HTTP '; cat diagnostic-status.txt
awk 'tolower($1) == "retry-after:" {
$1=""; sub(/^ /, ""); sub(/\r$/, ""); print "Retry-After: " $0
}' diagnostic-headers.txt
if jq -e 'type == "object"' diagnostic.json >/dev/null 2>&1; then
jq '{access, scopes, status, code, requestId}
| with_entries(select(.value != null))' diagnostic.json
else
printf 'Non-JSON response saved in diagnostic.json; check the HTTP status.\n'
fi
)flashdata account limits400 / 422: مرفوض أو فشل في التجهيز
اقرأ الرمز والتفاصيل و fieldErrors من خطأ HTTP. تصحيح الجسم الطلب، وإنقاذه كما request.jsonثم تحقق من ذلك. احتفظ بوثائق التخزين في ملف خاص إذا 422 يأتي من نتيجة العمل الحالي، التفتيش job.error أولاً
flashdata query --input request.json --mode async --dry-run --jsonوظيفة معلقة، أو HTTP 200 مع وظيفة فاشلة
اقرأ الوظيفة من submission.json(إيصالك المنقذ (أسينك HTTP 200 means the status read succeeded; job.status is the task outcome (data.status in CLI JSON). بالنسبة للزجاجة (Batch) ، وفروا من التساؤلات ذات الصلة بـ (submission.json).
| الدولة أو الخطأ | الإجراء التالي: |
|---|---|
| pending / processing | انتظروا في نفس العمل ولا تقدموه مرة أخرى |
| completed | أحضر و أنقذ النتيجة الحالية. |
| failed | Inspect job.error before submitting corrected work. |
| 404 | تحقق من وظيفة ID والحساب المقدم. |
| 409 | النتائج ليست جاهزة. استمري في التصويت على نفس العمل |
| 410 | مخزن JSON انتهت بعد ساعات 24. استعمل نسختك المنقذة و وسائل الإعلام المُرسلة لديها مخزن خاص بها |
# Bash + jq. CLI receipts use remoteId; HTTP receipts use id.
(
set -e
JOB_ID=$(jq -er '.remoteId // .id' submission.json)
flashdata jobs get "$JOB_ID" --json
)flashdata jobs wait JOB_IDflashdata jobs result JOB_ID --output recovered-result.json# Bash + cURL + jq. Read the saved async submission receipt.
(
set -e
test -n "$FLASHDATA_API_KEY" || { printf 'Set FLASHDATA_API_KEY first\n' >&2; exit 1; }
STATUS_URL=$(jq -er '(.submission // .).links[]
| select(.rel == "self") | .href' submission.json)
curl --fail-with-body --silent --show-error --max-time 30 \
--header "X-API-Key: $FLASHDATA_API_KEY" \
--header 'Accept: application/json' \
"$STATUS_URL" --output job.json
jq '.job | {id, status, error}' job.json
)وقت مستقطع/ 5x: هل تم قبول المهمة؟
افحص التنفيذ الأصلي وHistory قبل إعادة POST. استعد مهمة تأكد قبولها. إذا كان القبول غير معروف، فاحتفظ بمعرّف التنفيذ واتصل بالدعم؛ فقد يؤدي تغيير المعرّفات وإعادة الإرسال إلى رسوم مكررة.
flashdata runs show RUN_IDflashdata runs recover RUN_IDCLI output_exists: ملف النتيجة موجود بالفعل
لا تبالغ شركة CLI في كتابة ملفات --output. اقرأ الملف الحالي، أو اختار اسم ملف جديد للناتج مع الاحتفاظ بالاسم الأصلي --run-id وطلب. لا تخترعي طائرة جديدة من طراز ID لتجاوز هذا الخطأ.
flashdata runs show RUN_IDالتفتيش الفارغ، الخسائر المفقودة أو التحميل غير القابل للقراءة
هذه الأوامر فقط تقرأ ملفات النتائج المحلية، وليس ملفات النتائج المحلية CLI' stdout ظرف
إذا تم وضعه و العضوي فارغ، مرشحات الاستفسارات المطلة. حافظ على النتيجة الفارغة في سجل المهمة الخاص بك.
jq '{status, usage, resultCount: (.results | length)}' result.json
jq '(.results[0].organic // []) | length' result.jsonتسرد البيانات الوصفية رموز اللغات، لا ما إذا كان المسار يدويًا أو تلقائيًا. اختر لغة مدرجة واضبط auto صراحة: true للتلقائي وfalse لليدوي. غياب مسار مطابق يعني غياب الترجمات النصية لذلك الاختيار؛ ولا تنشئ FlashData بديلًا.
jq '.results[0].transcriptLanguages' metadata.jsonإقرأْ المنجز delivery.json الإيصال تحميل الجسم بوثائق التفويض الخاصة بتخزين الوجهة، ثم مقارنة حجمه و MD5 مع الإيصال. ولا تصبح شركة زيكروزكك (file_url) الخاصة من الجمهور بعد الولادة.
jq '.results[0] | {file_url, file_size, md5}' delivery.jsonمعدات MCP مفقودة أو انتهت صلاحية التوثيق
تحقق من المضيف الذي يدير المهمة. الخادم المدرج يؤكد التكوين وليس علاقة عمل وإذا كان الوصل الذي استضافه المكون هو OAuth يتطلب قطع الأشجار، وإدارة أمره بالقطع، والموافقة الكاملة على المصفوفين، ثم تجديد قائمة الأدوات.
افتح /mcp في Codex CLI لفحص حالة الاتصال والأدوات. في التطبيق، افحص الخادم المُعدّ وابدأ جلسة جديدة بعد تغييرات الإعداد.
codex mcp listcodex mcp login flashdata --scopes mcp:researchopenclaw mcp doctor flashdata --probeopenclaw mcp login flashdata
openclaw mcp doctor flashdata --probeOAuth الدخول لا يصلح API-الصلة الرئيسية تحقق من المفتاح في بيئة المضيف وأذنه المصدرية للمستوي المحلي، تحقق من MCP طرد Node.js الاحتياج وإعادة تشغيل المضيف بعد تحديث بيئته.
node --versionتم تركيب السكاكين لكن العميل لا يستطيع العثور عليه أو استخدامه
تحقق من نفس المشروع، وضميمة الاستضافة، وتركيب الموقع، ثم بدء دورة عميل جديدة. وتحتاج مهارات مهمة CLI إلى مقر CLI؛ وتحتاج شركة " وميضدات - مكب " إلى خادم متصل من طراز MCP. إن تركيب مهارة لا يربط الخادم أو تصريحات حساب المنح.
flashdata skills verify --agent codexflashdata skills verify --agent codex --skill flashdata-mcpopenclaw skills list --eligible
openclaw skills checkالأسئلة المطروحة مراراً
الحصول على اتصال
هل أحتاج إلى عميل في وكالة الاستخبارات؟
لا استخدام HTTP API, Go/Python/TypeScript SDK, CLI أو تأجير مباشرة. MCP والمهارات هي خيارات إضافية للعملاء.
أي واجهة يجب أن أختار؟
إستخدم SDK أو HTTP API داخل تطبيق CLI بالنسبة للمهام النهائية، MCP من أجل MCP-مضيف كبير وتوفر المهارات تعليمات إما لمهام CLI أو أدوات مرتبطة بـ MCP؛ ولا تحل محل التوثيق.
هل يمكنني إعادة استخدام وثائق التفويض للمهام المتكررة؟
نعم. استخدام وصول المالك والحفاظ على نفس الحماية CLI موجز أو سر غير متكرر أو MCP الإتصال. For API-مدخل جيد، تحقق recurringAllowed: true. مضيفك أو مبرمجك يدير الجدول الزمني
هل حذف الأماكن المحلية يلغي الدخول؟
لا "أكره" API مفتاح أو وصلة في النقابة. تحرير البيئات المحلية يزيل فقط تلك النسخة المحلية.
المحاكمات والائتمانات
هل يمكن للعميل أن يحاول FlashData قبل التوقيع؟
نعم، بوصول مؤقت مؤهل عبر CLI أو Onboarding API. أعد استخدام الملف الشخصي وإثبات التسجيل نفسيهما. يتطلب الاستمرار ربط الحساب أو مفتاح API مالك موجودًا.
هل تدّعي إضافة منحة تجربة أخرى؟
والمطالبة نفسها لا تمنح أي ائتمانات إضافية للتجربة. طلبات المستقبل تستخدم رصيد حساب المالك، الائتمانات المؤقتة غير المستخدمة لا تنقل. ويتبع حساب أنشئ حديثا سياسة الاعتماد العادية للإشارة.
كم عدد الطلبات التي يمكن أن تغطيها إئتماناتي؟
رصيد الحساب وتسعير المصدر. ويعتمد الطلب على المصدر، وتتقاسم المهام ذات الموارد المختلطة توازنا واحدا. ويُقدر سعر زيك زكسك (YouTube Download) بالشحنات المحملة من طرفات، وليس بالعد المحدد للطلبات.
المصادر والنتائج
لماذا يفتش عميلي لكن لا يحمّل؟
ويحتاج الحمولة إلى وصول المالك، وإلى إذن من شركة youtube_download، وإلى مخزن للمقصد. المحاكمات المؤقتة mcp:research OAuth لا تشمل الحمولة. ويمكن للمالك المأذون به مفتاح API أن يستخدمه من خلال CLI أو HTTP أو MCP.
لا Google Search أرجع الصفحات الكاملة على الإنترنت؟
إنها تعيد نتائج البحث والمقتطفات تطبيقك أو وكيلك يقرأ URLs.
لا FlashData تولد ملخصات للفيديو أو أغطية؟
إنه يسترد البيانات الوصفية والاختباءات الموجودة إنه لا يولد أي إهانة مفقودة. نموذجك يكتب ملخصاً من النتائج المتاحة.
لا تزال عالقة؟ إرسال تقرير الحد الأدنى
أنقذوا HTTP الجسم الخطأ أو CLI JSON خطأ من stderr as diagnostic.json. لا يُستثنى من ذلك إلا بعد فشل القيادة احتفظ بالمفاتيح، ونسخة من الاستفسارات الخاصة ووقع على URLs خارج التقرير. لغير...JSON الردود، الإبلاغ HTTP الحالة من diagnostic-status.txt.
flashdata auth status --json 2> diagnostic.json# A saved HTTP error or CLI --json error; local files only.
date -u '+%Y-%m-%dT%H:%M:%SZ'
jq '(.error // .) as $e | {
status: ($e.httpStatus // $e.status),
code: $e.code,
requestId: $e.requestId,
runId: (.runId // $e.runId),
jobId: $e.remoteId,
retryAfter: $e.retryAfter
} | with_entries(select(.value != null))' diagnostic.jsonالوقت الذي يستغرقه مركز التجارة الدولية:
العميلة + النسخة:
المصدر + المرحلة (التاريخ/العرض/الاستطلاع/الصفحة):
HTTP Status + error code:
Request ID / job ID / run ID:
نتيجة العرض: مقبولة/مرفضة/غير معروفة
النتيجة المتوقعة مقابل النتيجة الفعلية: