ما هي واجهة (API) – شرح بسيط؟

صورة

تُشبه API كتيبًا للطلبات. حيث توضح ما يمكن طلبه، وتُحدد الشكل الذي سيصل به الطعام. ما يحدث في المطبخ لا يعنينا – ويمكن أن يتغير دون أن نشعر.

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

لماذا هذا مهم

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

ما الذي يُعتبر جزءًا من واجهة قوية

• المستندات. ما هي الطلبات المتاحة، وما هي الردود المتوقعة
• إدارة الإصدارات. يجب أن لا تؤثر التغييرات على المستخدمين الحاليين
• الحماية من الوصول. من يحق له الوصول إلى ماذا
• إدارة الأخطاء. ماذا يحدث إذا لم يستجب الطرف الآخر
• الحد من الاستخدام. حماية من التحميل الزائد

يُنسى البند الرابع بشكل شائع. واجهة بدون منطق تكرار تفقد البيانات دون أن تدرك.

السؤال العملي قبل أي اتصال

هل توجد API مستندت؟ إذا كانت الإجابة بنعم، فإن الاتصال سيكون مفهومًا. إذا كانت الإجابة لا، فسيظل تبادل الملفات – عمليًا، لكنه أبطأ، أكثر عرضة للأخطاء، ولا يعمل في الوقت الفعلي.

يجب أن تُجيب هذه السؤال قبل تقدير التكاليف، وليس بعدها.