واجهة برمجة التطبيقات (API) مثل نادل المطعم. أنت (البرنامج الأول) تعطي الطلب للنادل فيخبر المطبخ (البرنامج الثاني) ويعيد إليك الطعام. لا تحتاج أن تعرف كيف يعمل المطبخ؛ يكفي أن تعرف ما القائمة وكيف تطلب. وAPI هي «القائمة وقواعد الطلب» بين برنامجين.

أمثلة يومية#

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

طلب بسيط#

يستدعي البرنامج عنواناً محدداً ويستلم الرد عادةً بصيغة JSON:

Code
GET /api/products/12

يعيد الخادم معلومات المنتج رقم 12.

لماذا هي مهمة#

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

ملاحظات أمنية#

معظم واجهات API لها مفتاح وصول. هذا المفتاح كلمة مرور بحكم الواقع؛ لا تضعه في شيفرة جهة المتصفح ولا في مستودع عام، وغيّره فوراً إذا تسرّب.