English

مرجع الأخطاء

كل كود يمكن أن تراه من أي نقطة، وجسمه الحرفي، وما تفعله عنده. 503 قبل كل شيء، ثم سلّم المفتاح، ثم 422 بصيغة Laravel ورسائل عربية، و500 بنصّ الاستثناء.

آخر تحديث: 2026-09-21

في الصفحة دي

بالترتيب الذي تقع به

الكود المصدر الجسم ما تفعله
403 نصّ عادي عنوان IP محظور تم حظر الوصول من هذا العنوان. راجع مسؤول النظام لرفع الحظر
503 التكاملات معطَّلة {"error":"Integrations are currently disabled"} فعّل المفتاح العام في شاشة التكامل
401 لا مفتاح / خاطئ / غير نشط {"error":"Unauthorized"} راجع الترويسة والمفتاح؛ الرسالة لا تميّز عمدًا
403 مفتاح منتهٍ {"error":"API key expired"} أنشئ مفتاحًا جديدًا
429 تجاوز الحدّ {"error":"Too many requests","retry_after_seconds":N} انتظر N ثم أعد؛ أو ارفع حدّ المفتاح
422 تحقق {"message":"Validation failed","errors":{"field":["رسالة عربية"]}} أصلح الحقل المسمّى
404 مسودة Dynamics {"message":"Dynamics launch draft not found or expired."} رمز مجهول أو انقضت ساعته — حضّر من جديد
500 خطأ خادم {"message":"Error saving cheque log","error":"…"} سجّل النصّ وأبلغ الدعم

المغلّف الخارجي لـ422 بالإنجليزية والرسائل داخله بالعربية — عدا رسائل محلِّل نموذج Dynamics فبالإنجليزية عمدًا لأنها تسمّي حقولًا إنجليزية لمبرمج التكامل (أدناه). وحالة 503 لنقطتي Dynamics بالجلسة تأتي بـ{"message":"Integrations are currently disabled."} (بـmessage) — اعتمد على الكود لا على النصّ.

رسائل 422 — الإنشاء المباشر

الحقل الرسالة الشرط
bank_name اسم البنك مطلوب. غائب أو فارغ
cheque_number رقم الشيك {N} مستعمَل بالفعل على بنك {B} — اختر رقمًا آخر تكرار على شيك مؤكَّد لنفس البنك
cheque_number رقم الشيك {N} مستعمَل بالفعل على شيك بلا اسم بنك — اختر رقمًا آخر نفس التعارض واسم البنك فارغ
cheque_number هذا الرقم يخص دفتر شيكات — اطبعه من وضع الدفتر الرقم ورقة في دفتر لنفس البنك
cheque_number الرقم :number محجوز في دفعة مفتوحة (الدفعة #:batch) — اطبعها أو ألغِها أولًا. محجوز في دفعة قائمة بنفس الشركة
amount القيمة كبيرة جدًا — لا يزيد الجزء الصحيح عن {N} خانة. الجزء الصحيح يتجاوز الحدّ
amount كسر المبلغ يتجاوز خانات {العملة} ({خانتان عشريتان}). الكسر أطول من مقياس العملة
partner_id المستفيد لا يتبع شركة الشيك. شركة الشريك ≠ شركة المفتاح
bank_account_id الحساب البنكي المختار لا يتبع شركة الشيك. سلسلة الحساب لا تصل شركة المفتاح
cheque_book_id دفتر الشيكات المختار لا يتبع شركة الشيك. سلسلة الدفتر لا تصل شركة المفتاح
cheque_leaf_id ورقة الشيك المختار لا يتبع شركة الشيك. سلسلة الورقة لا تصل شركة المفتاح
company_id مفتاح الـAPI غير منسوب لشركة — عيّن شركته من شاشة «التكامل ← مفاتيح API». المفتاح بلا شركة
company_id الحمولة تطلب شركة «{الحمولة}» بينما مفتاح الـAPI منسوب لشركة «{المفتاح}» — احذف الحقل أو استعمل مفتاح الشركة الصحيحة. company_id يخالف شركة المفتاح
external_id السجل ده مسجّل لشركة تانية. الصف المطابق بالمفتاح الخارجي مختوم لشركة أخرى
— رسالة الصف النهائي (تالف · ملغى · مُعاد إصداره) لا يُحدَّث

رسائل 422 — محلِّل نموذج Dynamics (بالإنجليزية)

الحقل الرسالة الشرط
template_id The selected template could not be resolved. لا يقابل نموذجًا نشطًا
bank_id The selected bank could not be resolved. لا يقابل بنكًا
bank_name The selected bank could not be resolved. لا يطابق بنكًا وtemplate_name غائب
template_name Multiple active featured templates matched the request. Provide template_id or a more specific template_name. تطابق متعدد بأكثر من مُعلَّم نشط
template_name Template name is ambiguous. Provide template_id or bank_name. تطابق متعدد بلا تعدّد مُعلَّم
bank_name + template_name The selected bank could not be resolved. + The selected template could not be resolved for the provided bank label. الاثنان معًا لم يُحلّا
template_name The selected template could not be resolved. لم يطابق شيئًا والبنك محلول
template_name No active templates are available for the selected bank. البنك محلول بلا نماذج نشطة
template Provide template_id, or provide bank_id/bank_name so a single active featured template can be auto-selected, or send template_name with the bank. لا شيء صالح أُرسل

نصائح المعالجة

  • افحص الكود أولًا ثم errors لتسمية الحقل.
  • عامل 422 «مستعمَل بالفعل» على cheque_number كنجاح سابق إن كان نظامك يعيد الإرسال.
  • على 429 احترم retry_after_seconds — الحدّ لكل مفتاح لا لكل خادم.
  • على 401 لا تكرّر المحاولة آليًا؛ أبلغ.

صفحات ذات صلة

اطلب نسختك التجريبية مجانًا