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

البدء

الأسئلة الشائعة وحل المشكلات

تحقق من وصولك، اصلح طلب فاشل أو اعثر على جواب عن استخدام FlashData.

في هذه الصفحة

ابدأ بفحص الدخول المجاني

افحص المكان الذي فشلت فيه المهمة استخدام وثائق تفويضها الحالية؛ ولا تقدم هذه الأوامر أي استفسار.

إستعملْ وصولَكَ المنقذَ CLI. من أجل ملف مسمّى، ملحق --profile نيم إلى كل أمر هذه القراءات لا تنفق اياً من الأستفكار

الحساب الحر يقرأ
flashdata --version
flashdata doctor --offline
flashdata auth status --json

ما الذي سيتحقق منه؟

يجب أن تتضمن الهوية 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 --offline

401 / 403: key, scope or expiry

لتستبدل مفتاح المالك المنقذ، وتضع المفتاح المعتمد في العجلة الخفية. وإذا تم تحديد موقع FLASHDATA_API_KEY، يستكمل هذا السر في وقت التشغيل بدلا من ذلك؛ وإنقاذ مفتاح آخر من مفتاح CLI لن يلغيه.

  1. 401: التحقق من أنه قد انتهى صلاحيته أو ألغيه أو غير صحيح. 403: مقارنة المصدر المطلوب مع نطاقات الهوية
  2. يستخدم 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

402: عدم كفاية الائتمانات

Compare availableCredits مع السعر الحالي لمصدرك اطالب بتجربة مرهقة لاستعمال رصيد المالك او دع المالك يراجع Billing قبل إعادة التجريب

إستعملْ وصولَكَ المنقذَ CLI. من أجل ملف مسمّى، ملحق --profile نيم إلى كل أمر هذه القراءات لا تنفق اياً من الأستفكار

الحساب الحر يقرأ
flashdata account balance
flashdata account pricing --source google_search --request-count 1

429: Wait before retrying

اقرأ Retry-After على الرد الفاشل: ثوان أو تاريخ HTTP. انتظر حتى ذلك الحين وقلل من التناسق. ويسمح تسجيل المحاكمات بثلاثة تسجيلات لكل مدخل من طراز IP لكل نافذة من نافذة 24-ساعة؛ وإعادة استخدام الملف الأصلي وإثبات التسجيل.

توضح هذه القراءة المجانية حفظ الترويسات والحالة والجسم. استخدم Retry-After من العملية التي فشلت؛ فقد تختلف حدود الاستعلام والتسجيل وقراءة الحساب.

الاستجابة: Bash / cURL / jq
# 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 limits

400 / 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أحضر و أنقذ النتيجة الحالية.
failedInspect job.error before submitting corrected work.
404تحقق من وظيفة ID والحساب المقدم.
409النتائج ليست جاهزة. استمري في التصويت على نفس العمل
410مخزن JSON انتهت بعد ساعات 24. استعمل نسختك المنقذة و وسائل الإعلام المُرسلة لديها مخزن خاص بها
Inspect the Save job · Bash / jq
# 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
)
لا يزال يعمل / استخدام JOB_ID
flashdata jobs wait JOB_ID
:: استخدام اسم ملف جديد للنواتج
flashdata jobs result JOB_ID --output recovered-result.json

وقت مستقطع/ 5x: هل تم قبول المهمة؟

افحص التنفيذ الأصلي وHistory قبل إعادة POST. استعد مهمة تأكد قبولها. إذا كان القبول غير معروف، فاحتفظ بمعرّف التنفيذ واتصل بالدعم؛ فقد يؤدي تغيير المعرّفات وإعادة الإرسال إلى رسوم مكررة.

Inspect first · replace RUN_ID
flashdata runs show RUN_ID
Recover confirmed work accepted
flashdata runs recover RUN_ID

CLI output_exists: ملف النتيجة موجود بالفعل

لا تبالغ شركة CLI في كتابة ملفات --output. اقرأ الملف الحالي، أو اختار اسم ملف جديد للناتج مع الاحتفاظ بالاسم الأصلي --run-id وطلب. لا تخترعي طائرة جديدة من طراز ID لتجاوز هذا الخطأ.

تحقق من الركض الأصلي
flashdata runs show RUN_ID

التفتيش الفارغ، الخسائر المفقودة أو التحميل غير القابل للقراءة

هذه الأوامر فقط تقرأ ملفات النتائج المحلية، وليس ملفات النتائج المحلية CLI' stdout ظرف

معدات MCP مفقودة أو انتهت صلاحية التوثيق

تحقق من المضيف الذي يدير المهمة. الخادم المدرج يؤكد التكوين وليس علاقة عمل وإذا كان الوصل الذي استضافه المكون هو OAuth يتطلب قطع الأشجار، وإدارة أمره بالقطع، والموافقة الكاملة على المصفوفين، ثم تجديد قائمة الأدوات.

افتح /mcp في Codex CLI لفحص حالة الاتصال والأدوات. في التطبيق، افحص الخادم المُعدّ وابدأ جلسة جديدة بعد تغييرات الإعداد.

تشكيلة تحقق
codex mcp list
فقط عندما يكون مطلوباً من شركة OAuth
codex mcp login flashdata --scopes mcp:research

تم تركيب السكاكين لكن العميل لا يستطيع العثور عليه أو استخدامه

تحقق من نفس المشروع، وضميمة الاستضافة، وتركيب الموقع، ثم بدء دورة عميل جديدة. وتحتاج مهارات مهمة CLI إلى مقر CLI؛ وتحتاج شركة " وميضدات - مكب " إلى خادم متصل من طراز MCP. إن تركيب مهارة لا يربط الخادم أو تصريحات حساب المنح.

تحققي من حزمة المهارات في الزورق CLI
flashdata skills verify --agent codex

الأسئلة المطروحة مراراً

الحصول على اتصال

هل أحتاج إلى عميل في وكالة الاستخبارات؟

لا استخدام 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.

التقط مجاناً CLI :: التحقق من إمكانية الوصول؛ Bash
flashdata auth status --json 2> diagnostic.json
:: تحديد هوية الأخطاء المستقطعة؛ Bash / jq
# 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:
نتيجة العرض: مقبولة/مرفضة/غير معروفة
النتيجة المتوقعة مقابل النتيجة الفعلية: