رسالة الخطأ جزء من واجهة المنتج، سواء قرأها مستخدم أو برنامج. استخدام حالة HTTP مناسبة يسمح للعميل باتخاذ قرار مثل تصحيح المدخلات أو إعادة تسجيل الدخول.
الفكرة الأساسية
افصل بين الطلب غير الصحيح، وعدم السماح بالوصول، وتعطل الخدمة. أعد وصفًا آمنًا ومختصرًا ومعرف تتبع يساعد فريق الدعم في العثور على التفاصيل داخل السجلات.
خطوات عملية
- وثّق الحالات الممكنة لكل عملية مهمة.
- اجعل الأخطاء المتوقعة قابلة للتمييز برمز ثابت.
- احتفظ بتفاصيل قاعدة البيانات والاستثناءات في السجل الداخلي.
مثال تطبيقي
إذا كان البريد مستخدمًا بالفعل، قد تعرض الواجهة رسالة تصحيح مناسبة وفق سياسة الخصوصية. أما تعطل قاعدة البيانات فيحتاج رسالة مؤقتة مختلفة، وليس لوم المستخدم.
خطأ شائع ينبغي تجنبه
لا ترسل دائمًا 200 مع حقل يحمل كلمة error؛ فهذا يربك الوسطاء والمراقبة والعملاء الذين يعتمدون على دلالة البروتوكول.
للتوسع في الموضوع
صور توضيحية: الغلاف من Unsplash، الصورة الداخلية من Unsplash. ترخيص الاستخدام.
