المنهج الدراسي الدرس 67 من 148 · واجهات برمجة تطبيقات لا يمكن لأحد إساءة استخدامها
واجهات برمجة تطبيقات لا يمكن لأحد إساءة استخدامها

إساءة الاستخدام بالتصميم

لماذا هذا مهم معظم الأخطاء عند حدود API ليست في الـ API. إنها في المستدعي الذي استخدمه بطريقة بدت صحيحة وقامت بالشيء الخاطئ بصمت. لا يمكنك إصلاح كل مستدعي؛ يمكنك جعل الاستخدام الخاطئ مستحيلاً، أو ظاهراً.

يميل المساعد الذي يكتب API إلى أن يكون مفيداً: إذا أرسلت قبل الاتصال، فإنه يتصل نيابة عنك؛ إذا مررت string حيث كان من المتوقع bytes، فإنه يقوم بتشفيره؛ إذا نسيت خياراً، فهناك قيمة افتراضية. كل لفتة طيبة تخفي خطأً حتى يظهر في مكان بعيد.

افشل مبكرا، وافشل بصوت عالٍ: ارفع خطأ عند الاستدعاء الخاطئ بالضبط، قبل أن يتغير أي شيء، مع رسالة توضح ما كان متوقعا.

أربع أدوات

  • حالات صريحة: كائن يعرف ما إذا كان جديدا أو مفتوحا أو مغلقا، ويرفض الاستدعاءات التي لا تتوافق معه.
  • خيارات مسمى، لا قيم منطقية: لا يمكن تبديل mode="dry_run" مع علم آخر بالخطأ؛ يمكن تبديل copy(a, b, True, False).
  • لا توجد قيم افتراضية صامتة للخيارات التي يكون الخطأ فيها خطيرا: اجعل المستدعي يحددها.
  • أنواع تحمل معنى: المال الذي يعرف عملته لا يمكن إضافته إلى مال بعملة أخرى.

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

خلاصة التخمينات المفيدة تخفي الأخطاء. ارفض الاستخدام الخاطئ عند الاستدعاء الذي هو خاطئ، قبل أي تأثير.

هل لاحظت مشكلة في هذا الدرس؟ أبلغ عنها · اسأل عن هذا الدرس

سيفتح هذا التمرين قريبا

أنهِ الدرس السابق ليفتح هذا الدرس. الدورة كاملة مجانية، ولا تحتاج إلى حساب، ويمكنك قراءة هذا الدرس الآن.