ما هو API؟

التعريف المختصر

API اختصار لعبارة Application Programming Interface، أي واجهة برمجة التطبيقات. هي مجموعة من العناوين والقواعد التي تنشرها خدمة ما، فيستطيع أي برنامج آخر أن يرسل لها طلبًا بصيغة محددة ويتلقى ردًا بصيغة محددة، غالبًا بصيغة JSON.

شرح مبسط

تخيل موظف الاستقبال في فندق: لا تدخل أنت إلى المطبخ ولا إلى غرفة الحجوزات، بل تطلب منه ما تريد بطريقة معروفة، فيرجع لك بالنتيجة. واجهة API تؤدي الدور نفسه بين البرامج: تخفي التفاصيل الداخلية، وتعطيك بابًا واحدًا واضحًا تطرقه.

كل طلب إلى API يتكون عادةً من أربعة أجزاء:

• العنوان (Endpoint): الرابط الذي ترسل إليه الطلب، مثل /api/orders.
• نوع الطلب (Method): GET للقراءة، POST للإنشاء، PUT أو PATCH للتعديل، DELETE للحذف.
• المفتاح (API Key): رمز سري يثبت أن الطلب صادر من تطبيقك، ويجب ألا يظهر في واجهة الموقع.
• الرد (Response): البيانات المطلوبة مع رمز حالة يخبرك هل نجح الطلب أم لا.

GET /api/bookings?date=2026-11-12
Authorization: Bearer <API_KEY>

200 OK
[
  { "id": 41, "name": "نورة", "service": "قص شعر", "time": "16:30" },
  { "id": 42, "name": "ريم", "service": "صبغة", "time": "18:00" }
]

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

ومن العلامات التي تراها كثيرًا رموز الحالة: 200 يعني أن الطلب نجح، و 401 يعني أن المفتاح غير صحيح أو مفقود، و 404 يعني أن العنوان غير موجود، و 429 يعني أنك تجاوزت عدد الطلبات المسموح به في دقيقة، و 500 يعني خطأ داخل الخدمة نفسها. معرفة هذه الأرقام الخمسة وحدها توفر عليك نصف وقت تشخيص أي مشكلة ربط، لأنك تعرف فورًا هل الخلل عندك أم عند المزود.

مثال من السوق السعودي

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

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

كيف يظهر في أوترا

في أوترا تستطيع أن تبني واجهة خلفية (API) كاملة لمشروعك مع قاعدة بيانات، من ملف SQLite بسيط إلى PostgreSQL أو MySQL، والبيئة تشغل الخادم وقاعدة البيانات معًا. ولربط خدمة خارجية تضيف مفتاحها في «البيانات السرية» ثم تطلب الربط بالمحادثة؛ وهناك أسماء شائعة جاهزة مثل STRIPE_SECRET_KEY و OPENAI_API_KEY، والمفتاح يبقى خارج المحادثة والكود.

مصطلحات ذات صلة

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