البوّابة بين البرامج
API هي البوّابة التي يستخدمها برنامج ليطلب من برنامج آخر شيئاً. بها تتحدّث الواجهة الأمامية مع الخلفية — وبها تتحدّث شِفرتك مع نموذج. تعلّمها مرّة واحدة، وينتظم معها معظم البرمجيات.
تسأل، فيُجيب
معظم واجهات API على الويب تتبع أسلوباً يُسمّى REST. تُرسل طلباً إلى نقطة نهاية، فتصلك استجابة.
- نقطة النهاية هي URL مضافاً إليه فِعل — شيء محدّد يمكنك فعله
- GET يقرأ البيانات · POST يُنشئها
- PUT يستبدل · PATCH يعدّل · DELETE يحذف
- كل استجابة تحمل رمز حالة — 200 يعني أنّ كل شيء على ما يُرام، و404 يعني غير موجود
الجميع يتحدّث JSON
JSON هي صيغة البيانات التي يتّفق عليها الطرفان. إنها بنية بسيطة من مفتاح/قيمة — تسمية ثم قيمتها — يستطيع أي لغة قراءتها وكتابتها.
المفاتيح والحدود
كلاهما يهمّ لحظةَ استدعائك واجهة API لنموذج مدفوع.
ما الخدمة
الخدمة خلفية بلا شاشة خاصة بها — لا أزرار ولا صفحات. تستدعيها برامج أخرى عبر واجهة API الخاصة بها، وتفعل شيئاً بالإجابة.
طبّقها
كيف تنفّذها: اكتب نقطة نهاية واحدة يحتاجها أداتك، بالشكل «VERB /path ← تُعيد ماذا». مثلاً: POST /tasks ← المهمة المُنشأة. هذا السطر الواحد عقدٌ بين برنامجين.
- مُتتبِّع مهام الذكاء الاصطناعي الأسبوعي — يُسلّم تطبيق المراسلة الرسائل إلى خلفيتك عبر webhook — نقطة نهاية يستدعيها — ويُوصَل إلى LLM عبر واجهة API الخاصة به. انتبه للمصادقة وحدود المعدّل.
- موقع علامتك الشخصية — إن كان ثابتاً، فقد لا يستدعي أي واجهة API إطلاقاً؛ وإن ولّد شيئاً وقت البناء، فتلك مكالمة API واحدة تُجريها مرّة.
ما تعلّمته
API بوّابة؛ ونقاط نهاية REST هي URL مع فِعل؛ وJSON هي صيغة البيانات المشتركة؛ والمفاتيح تُثبت هويتك وحدود المعدّل تحدّ من عدد مرّات الاستدعاء؛ والخدمة خلفية تصل إليها برامج أخرى — ومزوّد LLM هو ما ستستخدمه أكثر شيء.