ما هي الـ API بطريقة مبسطة؟

الواجهة البرمجية (API) هي «قائمة الطعام» الرسمية لأي خدمة: تخبرك بما يمكنك طلبه، وبأي صيغة تطلبه، وماذا ستستلم. أنت لا تدخل المطبخ ولا تعرف كيف تُطبخ الوجبة، ويكفيك أن الاسم والوصف والسعر واضحة. هذا التشبيه يشرح أهم فكرة في التكامل: الفصل بين الواجهة والتنفيذ. الخدمة قد تعيد كتابة نظامها بالكامل، وما دامت الواجهة ثابتة فتكاملك يستمر بلا تعديل. كل واجهة برمجية تُعرَّف بأربعة أشياء: 1) العنوان (Endpoint): مسار الوظيفة، مثل مسار «قائمة العملاء». 2) الفعل (Method): ماذا تريد أن تفعل — قراءة، إنشاء، تعديل، حذف. 3) المدخلات: ما ترسله من معطيات أو جسم طلب. 4) المخرجات: ما تستلمه، وغالباً بصيغة JSON. وهناك ثلاثة قيود عملية لا تنساها: الحدود (Rate Limits) وهي عدد الطلبات المسموح بها في فترة، والإصدارات (Versioning) لأن الخدمات تطوّر واجهاتها، والتوثيق (Docs) وهو مرجعك الحقيقي — لا تخمّن أبداً ما يمكن للواجهة فعله. مهم لهذا المسار: الذكاء الاصطناعي لا «يفهم» الواجهة بالسحر. أنت من يصف له ما تفعله كل وظيفة ومتى تُستخدم. لاحقاً سنرى أن MCP هو محاولة لجعل هذا الوصف موحّداً وقابلاً للاكتشاف تلقائياً.