الطلبات وحالاتها
خطأ الطلب
آخر تحديث: ، من إعداد فريق تحرير PanelCompare
ما أهمية خطأ الطلب للمشتري؟
سلوك HTTP هذا أخطر خصوصية في المواصفة. فالأخطاء تعيد الحالة 200 مع نص مثل حقل error مكتوب فيه «Incorrect request»، فلا تحمل رموز الاستجابة أي معلومة، ويجب على كل تكامل تحليل النص (تم التحقق مقابل justanotherpanel.com/api، أبحاث PanelCompare عن السوق، 2026-09-06). والسكربت الذي يثق بـres.ok سيبلّغ بسعادة عن مئة طلب مرفوض على أنها وُضعت. وإحدى اللوحات الكبيرة تردّ فوق ذلك على المفتاح الخاطئ بـHTTP 401 ونص خطأ بصيغة JSON، فيجب تحليل رموز 4xx أيضًا لا اعتبارها «لا يوجد API هنا».
أما لمن يطلب يدويًا فالأخطاء أضيق ومعظمها من صنع المشتري: رابط بشكل لا يناسب الخدمة، أو كمية دون الحد الأدنى أو فوق الحد الأقصى، أو رصيد غير كافٍ في المحفظة، أو صف عطّلته اللوحة منذ آخر تحميل للقائمة. والأخير يستحق الانتباه، لأن السعر الرئيسي الذي يصبح غير متاح لحظة شحن المحفظة أسلوب الطُّعم والتبديل لا عطل.
كيف تجد خطأ الطلب في قائمة الأسعار؟
الأخطاء لا تظهر في قائمة الخدمات؛ تظهر عند الإرسال. وحقول min وmax وtype في القائمة هي التي تحدد معظمها، ولهذا فإن قراءة هذه الأعمدة الثلاثة قبل الطلب تمنع معظم حالات الرفض.
في الطلب الجماعي تُفحص الدفعة كلها وتُسعَّر عادةً قبل التأكيد، فيُكتشف السطر المشوّه مبكرًا، لكن الدفعة التي تجتاز الفحص تُرسل إجراءً واحدًا، ونافذة الإلغاء تنطبق عندها على الكل دفعة واحدة.
هل ترى أن هذا التعريف خاطئ؟
المصطلحات في هذه السوق تحددها اللوحات التي تستخدمها، وهي تتغيّر. إن كانت لوحةٌ تستخدم مصطلح خطأ الطلب بمعنى غير المكتوب هنا، فأرسل إلينا العرض، وسنصحح التعريف أو نسجّل المعنى البديل. والإجراء مشروح في صفحة «من نحن».