API: ربط خدمات الآخرين

الدرس 16 من 26 في دورة «البرمجة بالإحساس». مجاني، مع رسوم متحركة واختبار.

API: برامج تتحدث

الـ API (واجهة برمجة التطبيقات) طريقة يطلب بها برنامج من برنامج آخر أن يفعل شيئًا. مثل النادل: لا تدخل المطبخ، بل تعطيه طلبك فيأتيك الطبق. خادمك يرسل طلبًا، والخدمة ترد ببيانات. مثال هذا الدرس: موقع حجز لصديقك الحلاق. يحجز الزبون، فيرسل الموقع بنفسه رسالة بريد، ويأخذ دفعة مقدمة، ويجيب عن الأسئلة.

ما الذي يمكنك ربطه

كل شيء مفيد تقريبًا موجود على شكل API. البريد: Resend أو Brevo ترسل «حجزك يوم الجمعة». الدفع: Stripe أو خدمة دفع محلية في بلدك. الذكاء الاصطناعي: واجهة Anthropic أو OpenAI ليجيب بوت عن الزبائن. وأيضًا الطقس والخرائط والترجمة. في الرسم هذا هو المربع على اليمين. تحقّق من توفر الخدمة والدفع في بلدك.

مسار المفتاح

طريقة الربط واحدة تقريبًا دائمًا. 1) تسجّل في الخدمة. 2) تحصل على مفتاح API: كلمة مرور للبرامج (درس المفاتيح). 3) تضعه في متغيرات البيئة على الخادم لا في الكود. 4) الخادم يستخدم المفتاح لمخاطبة الـ API. 5) الواجهة تخاطب خادمك فقط. المتصفح لا يرى المفتاح: كما في الرسم، يعيش المفتاح على الخادم.

الويب هوك: الخدمة تتصل بك

عادة أنت من يتصل: خادمك يسأل والخدمة تجيب. الويب هوك (webhook) هو العكس: الخدمة تطرق عنوان خادمك بنفسها عندما يحدث شيء. مثال: دفع الزبون ثمن الحلاقة، فترسل خدمة الدفع ويب هوك «تم الدفع»، ويعلّم خادمك الحجز بأنه مدفوع. هذا هو السهم المتقطع في الرسم. تحقّق من توقيع الويب هوك ليتأكد خادمك أن المرسل هو الخدمة فعلًا وليس شخصًا يمزح.

التوثيق ووضع الاختبار

التوثيق دليل الخدمة لاستخدام الـ API الخاص بها. أعطِ الوكيل رابط التوثيق واطلب أن يلتزم به: هكذا يخترع أقل. ابدأ بوضع الاختبار: لخدمات الدفع بيئة تجريبية يكون فيها الدفع وهميًا ولا تُسحب أموال. جرّب المسار كله: الحجز، البريد، الدفع، الويب هوك. يعمل؟ عندها فقط انتقل إلى المفاتيح الحقيقية.

اختبر نفسك

1. أين يجب أن يوجد مفتاح API لخدمة الدفع؟
   الإجابة الصحيحة: في متغيرات البيئة على الخادم. المفتاح على الخادم لا يراه المتصفح. الواجهة تطلب من خادمك، والخادم يخاطب الـ API بالمفتاح.
2. ما هو الويب هوك؟
   الإجابة الصحيحة: الخدمة تتصل بخادمك عندما يحدث شيء. عادة يسأل خادمك. الويب هوك هو العكس: الخدمة تخبرك بنفسها، مثل «تم الدفع».
3. كيف تبدأ ربط الدفع؟
   الإجابة الصحيحة: بوضع الاختبار حيث لا تُسحب أموال. في البيئة التجريبية تختبر المسار كله دون مخاطرة. فعّل المفاتيح الحقيقية حين يعمل كل شيء.

← قاعدة البيانات وتسجيل الدخول المهام الخلفية والجدولة →