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

مرجع API

الأخطاء ورموز الحالة

ابحث عن سبب فشل الطلب و تقرر ما إذا كانت ستصلحه أو تنتظره أو تعود

في هذه الصفحة

رموز مركز HTTP

ابدأوا HTTP الحالة، ثم قراءة رمز الخطأ ورسالة للسبب المحدد.

الحالةمعنىالإجراء المطلوب
400طلب غير مستوفىصلح المصدر، أو الحقول المطلوبة، أو أنواع البارامترات، أو رؤساء الاستجابة قبل إعادة التجريب.
401فشل التوثيقتحقق X-API-Key. يستعاض عن مفتاح منتهية أو ملغى؛ ولن يساعد تغيير المفتاح نفسه.
402عدم كفاية الائتماناتتحقق من رصيد الحساب يضاف الائتمانات أو يسمح لمالك الحساب بأن يحل الدخول قبل أن يقدم مرة أخرى.
403Access deniedتحقق من تصريحات المصدر و حالة الحساب أو الاشتراك
404لم يعثر عليهتحقق من URLعمل ID وحساب الوظائف خارج حسابك المسموح به أو مصادرك يمكن أيضا إعادة 404.
406نوع الاستجابة غير مقبولاستخدم Accept: application/json أو text/plain. اختر Markdown عبر X-Respond-With: markdown.
409النتيجة غير جاهزة/الصراعوبناء على ذلك، يُستعاض عن الوظيفة القائمة حتى تكتمل. ولغيرها من النقاط النهائية، حل النزاع الوارد وصفه في الجسم.
410انتهت صلاحية النتائجاستخدم نسخة محفوظة. إعادة محاولة رابط النتيجة لا تستعيد نتيجة انتهت صلاحيتها.
422عدم كفاية المدخلات/الوظيفة الفاشلةأصلح الحقول المبلغ عنها وبناء على ذلك، راجعت شركة job.error: فالوظيفة الفاشلة ليس لها أي نتيجة ناجحة للقبض.
429Limit reachedانتظر Retry-After أو retry_after. خفض معدل الطلب؛ وللاطلاع على استفسار كامل، انتظاراً للوظائف القائمة إلى finish.
500 / 502 / 503 / 504الخدمة أو الفشل في المراحل الأولىالتراجع يقرأ بالتراجع المقيد. وللاطلاع على رقم POST أو على موعد تقديم الطلبات، انظر ما إذا كان قد تم قبول العمل قبل إرساله مرة أخرى.

إقرأْ ردّاً خاطئاً

API استخدام الأخطاء JSONبما في ذلك عندما تطلبين نصاً سهلاً وتختلف الهيئة حسب نقطة النهاية. الفرع المعني بمركز ورمز HTTP عند وجوده؛ استخدام الرسالة أو التفاصيل لشرح المشكلة.

وتشمل الأخطاء في الأسعار عادة الخطأ والرسالة؛ والمدونة اختيارية. وقد تستخدم أخطاء التوثيق (success: false) بدلاً من error: true.

400 · application/json
{
  "error": true,
  "code": "unsupported_representation",
  "message": "X-Respond-With supports markdown. Omit the header for the original result fields."
}

حالة التفتيش والرؤس والجسد

الاستخدام curl --include لرؤية الثلاثة. هذا المثال يفحص مفتاحك بحساب مجاني، ولا يقدم استفساراً. المجموعة FLASHDATA_API_KEY في بيئتك أولاً

Inspect a response · cURL / Bash
curl --include --silent --show-error --max-time 20 \
  'https://api.flashdata.dev/v2/api-access/identity' \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json'

متى يُعيدُ النظر

متكرر POST يمكن أن يخلق استفساراً آخر قابلاً للتعديل. ولا يثبت انقطاع الشبكة أن الطلب الأول قد رُفض. انقذوا العمل ID بمجرد أن تستلمه

الحالةالإجراء التالي:
المدخلات غير الصحيحة أو المفاتيح أو الأذن أو التوازنتوقف اصلح الطلب أو الحساب قبل إعادة التجريب؛ ولا تُحدِث هذه الأخطاء.
429 with a wait hintأو قيمة Retry-After (ثانية أو تاريخ HTTP)، أو قيمة JSON retry_after في ثوان. وإذا كان كلاهما حاضرين، استخدموا التأخير الأطول.
طلب القراء: 429/ temporary 5x/ network errorأعيدي نفس الشيء GET. بدون تلميحاً للانتظار، استخدام التأخيرات المتزايدة مع جليس، ومحاولة قصوى للإحصاء والحد الزمني.
POST timeout or ambiguous 5xالحفاظ على الوظيفة الحالية ID وتحقق من حالتها إذا لم يكن ID ووردت، وفتشت تاريخ العمل قبل أن تقرر تقديمه مرة أخرى.

تحقق من وظيفة خلفية

يعني HTTP 200 من نقطة الحالة أن القراءة نجحت. افحص job.status لمعرفة ما إذا كانت المهمة نجحت. اضبط JOB_ID على مهمتك الموجودة؛ فهذا الأمر لا يرسل بديلًا.

job.statusالإجراء المطلوب
pending / processingمهلاً، إذاً إستطلاع نفس الوظيفة ونتيجة لذلك، يُستعاض عن عبارة " 409 " بعبارة " .
completedاسترجع النتيجة واحفظها. تعيد نتائج JSON الأصلية توجيه 302 إلى التخزين؛ أما النتائج المنسّقة فتعيد الجسم مباشرة.
failedوقف الاقتراع والتفتيش job.error. The result endpoint returns 422 with code result_not_ready for a failed job.
اقرأ حالة العمل؛ cURL / Bash
curl --fail-with-body --silent --show-error --max-time 30 \
  "https://api.flashdata.dev/v2/jobs/${JOB_ID:?Set JOB_ID}" \
  --header "X-API-Key: ${FLASHDATA_API_KEY:?Set FLASHDATA_API_KEY}" \
  --header 'Accept: application/json'

الأخطاء الشكلية للرد

الحالة/الرمزFix
400 · unsupported_representationالمجموعة X-Respond-With لإيقاف أو إزالة الرأس.
406 · not_acceptableSet Accept to application/json or text/plain; use UTF-8 if specifying a charset.

الحصول على مساعدة مع طلب

أرسل نقطة النهاية والتوقيت بصيغة UTC وحالة HTTP ورمز الخطأ ومعرّف الطلب أو المهمة. أزل مفاتيح API والرموز وروابط URL الموقّعة من التقرير.