الموارد · 107

مهام API غير المتزامنة

قبول الطلب لا يثبت اكتمال العمل.

مُحدَّث ٨ أكتوبر ٢٠٢٦ · 2 min

ما يُساعد هذا الدليل على تحقيقه

1
تحديد الحالات والصلاحيات
ميّز القبول والانتظار والتنفيذ والاكتمال والفشل وطلب الإلغاء. HTTP 202 لا يضمن النجاح. تحقق من صلاحيات الحساب للحالة والنتائج والإلغاء؛ المعرّف لا يستبدل الإذن.
الحساب والعملية ومعرّف قابل لإعادة الاستخدام
2
استئناف المتابعة
احتفظ بالمرجع الموجود. حدد فاصل الاستعلام ومدته والانتهاء والتصرف عند غياب الحالة. إن وُجدت حماية من التكرار فوثّق نطاقها واختبر فقد الرد قبل تكرار الطلب.
الحالة والوقت والفاصل والانتهاء
3
تأكيد النتيجة
اختبر الإلغاء أثناء المعالجة أو النشر وفشل العامل وانتهاء النتيجة. افحص الآثار الباقية وأوقف الاستعلامات عند الوصول إلى حالة نهائية.
الناتج والخطأ والإلغاء والآثار الباقية

أكمل بملاحظاتك المعتمدة. هذه الحقول عبارة عن نموذج عمل، وليست نتائج مُلاحظة.

الحقل	المعلومات المطلوب تسجيلها
المرجع	الحساب والعملية ومعرّف قابل لإعادة الاستخدام
المتابعة	الحالة والوقت والفاصل والانتهاء
النتيجة	الناتج والخطأ والإلغاء والآثار الباقية
القبول	مهمة واحدة مأذونة ونتيجة متحققة بعد الانقطاع

مثال افتراضي: يضيع رد قبول التصدير ويحاول المستخدم مرة أخرى.

يفحص الاختبار هل يعيد عقد التكرار المهمة الموجودة. دون هذه الضمانة ينبغي التحقق من الطلب قبل إنشاء آخر؛ الواجهة لا تثبت عدم التكرار.

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

هل 202 يثبت أن العمل سيكتمل؟

لا. يؤكد القبول للمعالجة وليس النتيجة النهائية. افحص حالة العملية.

هل الإلغاء يمحو الآثار السابقة؟

ليس بالضرورة. أكد الحالة النهائية وطابق الآثار الموجودة.

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

تاريخ مراجعة المراجع ٨ أكتوبر ٢٠٢٦.