الأخطاء وإعادة المحاولة
ميّز بين خطأ الطلب، ورفض الصلاحية، وحالة مالية ما زالت غير محسومة.
اقرأ رمز HTTP وحالة العملية معًا
| الرمز | المعنى | التصرف |
|---|---|---|
| 400 / 422 | طلب غير صالح | راجع الحقول والقيم والحدود في المرجع. |
| 401 | مفتاح غير صالح | راجع المفتاح وإلغاءه وصيغة الترويسة. |
| 403 | صلاحية أو ملكية غير كافية | راجع الباقة والصلاحية ومالك المورد. |
| 404 | مورد أو مسار غير متاح | راجع المعرف والمسار وملكية المورد. |
| 409 | تعارض في البيانات أو الحالة | راجع الطلب السابق ومفتاح منع التكرار. |
| 429 | طلبات أكثر من الحد | انتظر ثم أعد المحاولة وفق سياسة الخادم. |
| 503 | تعذر تنفيذ الخدمة مؤقتًا | تحقق من الطلب القائم قبل إنشاء طلب بديل. |
عندما تنقطع الاستجابة
انقطاع الاتصال لا يثبت فشل العملية المالية. احتفظ بالطلب في حالة غير محسومة، واستعلم عن المورد المرتبط به، ثم أعد المحاولة بالمفتاح نفسه عند الحاجة.
تعيد أخطاء الخدمة الآمنة ok: false وerror. لا تجعل نصوص أخطاء داخلية غير موثقة عقدًا يعتمد عليه تطبيقك.
مرجع API الكاملتحديث الوثائق: 9 أكتوبر 2026