انتقل إلى المحتوى الرئيسي

ما هو الـ API ومتى تحتاجه شركتك؟

T
Tarek Ibrahim
•
ربط الموقع والتطبيق وأنظمة CRM وERP وبوابة الدفع باستخدام API

أغلب أصحاب الشركات بيسمعوا كلمة API لأول مرة في اجتماع مع مورد، وغالبا كبند في عرض السعر: “بوابة الدفع ليها API”، “محتاجين API للأبلكيشن”، “نظام الـ ERP عندكم بيوفر API”. الكلمة شكلها تقني، فسهل إنك تهز راسك وتعدي. والعادة دي غالية. لأن الـ API هو اللي بيحدد سرعة ربط السيستمات ببعض، وكام ساعة موظفينك بيضيعوها في إعادة كتابة نفس البيانات، وإزاي الشركاء والأبلكيشنز بيوصلوا لبياناتك بأمان، وهتدفع كام في أي ربط جاي.

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

يعني إيه API بالظبط

API اختصار لعبارة application programming interface. لو شلنا المصطلحات، هو اتفاق مكتوب: سيستم بينشر قايمة محددة بالطلبات اللي بيقبلها، والردود اللي هيرجعها بالظبط، فسيستم تاني يقدر يستخدمه من غير ما يعرف هو متبني من جوه إزاي.

التشبيه المشهور هو المطعم. إنت مبتدخلش المطبخ. بتقرا المنيو، وتطلب من الجرسون، وبيجيلك الطبق. المنيو هو الوثائق، والجرسون هو الـ API، والمطبخ هو الداتا بيز والمنطق بتاع شغلك. المطبخ ممكن يغير البوتجاز والطباخين والوصفات، وطول ما المنيو زي ما هو، الزباين هيفضلوا يطلبوا بنفس الطريقة.

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

إنت بتستخدم APIs كل يوم

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

تقريبا كل موقع حديث هو مجموعة محادثات API. فالسؤال للشركة مش “هل نستخدم APIs” لكن “هل نمتلك API بتاعنا”: واجهة لسيستماتك إنت، موقعك وأبلكيشنك وأدوات موظفينك وشركاؤك كلهم يستخدموها.

الطلب بيشتغل إزاي

أغلب الـ APIs في الشركات النهارده بتشتغل على HTTP، وهو نفس البروتوكول اللي المتصفح بيستخدمه. ولو عايز مرجع تقني واضح، وثائق MDN بتشرح طرق طلب HTTP وأكواد حالة HTTP المستخدمة في الـ APIs.

  • الـ Endpoint. العنوان اللي بتطلبه، زي مسار بيمثل الحجوزات أو المنتجات.
  • الـ Method. العملية: قراءة (GET)، إنشاء (POST)، تعديل (PUT أو PATCH)، أو حذف (DELETE).
  • الـ Headers. بيانات عن الطلب، منها المفتاح اللي بيثبت مين اللي بيطلب.
  • الـ Body. البيانات المبعوتة، غالبا بصيغة JSON، وهي نص خفيف الإنسان والجهاز بيقروه.
  • الرد. كود حالة (200 يعني نجح، 401 يعني مش مصرح، 404 يعني مش موجود، 429 يعني طلبات كتير أوي، 500 يعني مشكلة في السيرفر) وجسم JSON فيه النتيجة أو رسالة الخطأ.

الأسلوب ده اسمه REST وهو الأشهر، لكن مش الوحيد. GraphQL بيخلي الطالب يحدد الحقول اللي عايزها بس في طلب واحد، وده مناسب لشاشات موبايل معقدة. SOAP معيار أقدم على XML هتقابله لسه في البنوك والجهات الحكومية وأنظمة ERP القديمة. والـ Webhooks بتعكس الاتجاه: بدل ما تسأل “حصل حاجة جديدة؟”، السيستم التاني هو اللي بينادي على الرابط بتاعك لحظة ما يحصل حدث، زي نجاح عملية دفع. والربط الناضج غالبا بيخلط بينهم.

مخطط يوضح طريقة عمل طلب API من خلال الـ Endpoint وطريقة HTTP والـ Headers وبيانات JSON واستجابة السيرفر بأكواد الحالة

API عام وAPI للشركاء وAPI داخلي

مش كل API معمول للعالم كله، والجمهور بيغير متطلبات الهندسة.

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

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

الـ API العام مفتوح لأي مبرمج يسجل. ده محتاج أقوى تأمين وأفضل وثائق ووعد باستقرار طويل، لأنك مش هتقدر تنسق مع كل مستخدم.

أغلب الشركات محتاجة API داخلي الأول، وبعدين واحد أو اتنين للشركاء، ومش هتحتاج عام أبدا. بناء API عام وإنت ليك مستخدمين داخليين بس من أكتر الأسباب اللي بتخلي المشروع يعدي الميزانية.

امتى الـ API بيرجع تكلفته

الـ API مش هدف. هو أرخص طريقة تشيل بيها تكلفة معينة بتتكرر. دي الحالات اللي بنشوفها أكتر حاجة.

مصدر واحد للحقيقة للموقع والأبلكيشن وأدوات الموظفين

مجموعة فنادق عندها موقع وأبلكيشن وسيستم استقبال. من غير API كل واحد فيهم معاه نسخته من الأسعار والتوافر، وحد بيراجعهم بإيده. ومع API واحد قدام داتا بيز واحدة، التلاتة بيقروا ويكتبوا نفس البيانات. السعر بيتغير مرة واحدة ويتغير في كل حتة، وحالات الحجز الزايد بسبب نسخ قديمة بتختفي.

ربط الموقع بالـ ERP أو الـ CRM أو الحسابات

لما أوردر يوصل على الموقع، حد بيكتبه تاني في الـ ERP، وبعدين في الـ CRM، وبعدين يطلع فاتورة. كل إعادة كتابة بتاكل وقت وبتدخل أخطاء. ربط بيعمل العميل والأوردر والفاتورة أوتوماتيك بيشيل المجهود ونسبة الأخطاء مع بعض. لو الـ ERP أو الـ CRM ليه API، الشغل هو ربط الحقول والتعامل مع الفشل. ولو معندوش، فطبقة API قدامه هي الطريقة الآمنة إنك تعرض اللي محتاجه بس. بنتكلم عن ده أكتر في صفحة ربط CRM وERP.

أبلكيشنز الموبايل

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

التوزيع عن طريق الشركاء

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

بوابات العملاء وطلبات الجملة B2B

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

الأتمتة والتقارير

لما الداتا تبقى متاحة عن طريق API، الأدوات تقدر تستخدمها من غير مشاريع مخصصة: داشبورد، سلاسل إيميلات أوتوماتيك، تنبيهات مخزون، تقارير يومية للإدارة. الـ API بيحول كل واحدة من دول من مشروع لإعداد.

امتى مش محتاج API

الكلام المباشر في النقطة دي بيوفر فلوس العميل. غالبا مش محتاج تبني API لو:

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

اختبار مفيد: اكتب السيستمين، والداتا اللي لازم تتنقل بينهم، وكل قد إيه، وإيه تكلفة الفشل. لو معرفتش تسمي الطرفين والتكرار، يبقى لسه مش جاهز تطلب API.

إيه اللي بيفرق API كويس عن API وحش

اتنين API ممكن يشتغلوا في العرض التجريبي ويتصرفوا بشكل مختلف تماما على الإنتاج. لما تقيم عرض، دور على الصفات دي.

التحقق من الهوية والصلاحيات

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

التحقق من المدخلات والأخطاء المفهومة

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

منع التكرار (Idempotency)

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

حد الطلبات وحماية من الإساءة

من غير حدود، سكريبت واحد بايظ أو عميل عدائي واحد يقدر يحمل السيرفر ويوقع موقعك معاه. حد طلبات لكل مفتاح، وتقسيم صفحات القوائم الكبيرة، وحد لحجم الطلب، كلها بتخلي المنصة متوقعة. وتخزين نتايج الطلبات اللي بتتقرا كتير في CDN أو كاش في الأبلكيشن بيقلل الحمل ويسرع الرد لكل مستخدم شرعي.

إدارة النسخ (Versioning)

شغلك هيتغير، والـ API كمان. النسخ، زي رقم نسخة في المسار، بيخليك تضيف تغييرات من غير ما تكسر المستخدمين الحاليين، وبيدي الشركاء مهلة واضحة ينقلوا فيها. الفرق اللي بتتجاهل النسخ بتلاقي نفسها مش قادرة تطور سيستمها لأن كل تغيير بيهدد حد.

الوثائق والاختبارات

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

السجلات والمراقبة

لازم تشوف الطلبات الفاشلة والـ endpoints البطيئة والترافيك الغريب قبل ما عميل يبلغ عنها. سجلات للطلبات برقم تتبع، وتنبيهات للأخطاء، وendpoint بسيط لفحص الصحة، بيحولوا “في مشكلة في الربط” لتشخيص في خمس دقايق بدل بحث يومين.

الأمان: إيه اللي صاحب الشغل لازم يصر عليه

الـ API باب على بياناتك، فهو أول حتة المخترق بيدور فيها. الحد الأدنى لأي API في شركة: HTTPS في كل حتة، ولا أسرار في الكود أو في المتصفح، وفحص صلاحيات على السيرفر لكل سجل بدل ما نخبي الزراير في الواجهة بس، وحماية من أنواع الهجمات المعروفة زي الحقن والوصول غير المصرح لسجل، اللي فيها تغيير رقم في الطلب بيكشف بيانات عميل تاني. قايمة OWASP API Security Top 10 هي المرجع المعروف، وطلب معقول لأي مبرمج هو “وريني إزاي كل بند فيها متعامل معاه”.

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

ابني ولا اشتري ولا اربط: تلات طرق تجيب بيها API

استخدم الموجود. منصات كتير جاية بـ API جاهز. ووردبريس فيه REST API مدمج، وWooCommerce بيوسعه للمنتجات والأوردرات، وأغلب مزودي الدفع والشحن والرسايل ليهم API منشور. لو المطلوب نقل داتا بين منتجين من دول، ممكن ربط مباشر أو أداة أتمتة تكفي، وده أرخص طريق.

وسع منصة موجودة. لما ووردبريس أو سيستم قائم هو المكان الصح لمحتواك وعملياتك، بلجن أو موديول مخصص ممكن يضيف الـ endpoints اللي محتاجها، مؤمنة بأدوار المنصة نفسها. ده بيحافظ على لوحة تحكم مألوفة لفريقك ويحصر الكود الجديد في اللي هو فعلا جديد. شوف شغلنا في تطوير وبرمجة المواقع.

ابني باك إند مخصص. لما المنطق هو المنتج نفسه، زي حجوزات بقواعد معقدة أو بوابات متعددة الأدوار أو محركات تسعير أو ربط تقيل، باك إند متبني بفريمورك زي Laravel بيديك هيكل وطوابير للمهام البطيئة وقابلية للاختبار. والموقع والأبلكيشنز يبقوا مجرد عملاء للـ API ده. مقالنا عن ووردبريس ولا لارافيل بيشرح معايير القرار، وصفحة برمجة Laravel بتوري إزاي بنشتغل.

الحل الهجين شائع وبيشتغل كويس: واجهة ووردبريس للمحتوى التسويقي والسيو، وخلفها API بـ Laravel للمنطق المعاملاتي.

إيه اللي بيحدد تكلفة الـ API

مش بنكتب أرقام في مقال عام لأن النطاق بيختلف جدا، لكن العوامل ثابتة ومفيد تعرفها قبل ما تطلب أسعار.

  • عدد الموارد وتعقيدها. عشر endpoints على سجلات بسيطة مشروع غير أربعين endpoint بقواعد متداخلة.
  • قواعد الشغل. التسعير والتوافر ومسارات الموافقة والصلاحيات بتاخد وقت أكتر بكتير من نقل الحقول.
  • عدد التكاملات. كل سيستم خارجي له عيوبه وحدوده وفترات توقفه، وكل واحد محتاج معالجة أخطاء ومراقبة.
  • جودة السيستم على الطرف التاني. ERP حديث بوثائق واضحة سريع الربط. وسيستم قديم من غير API ممكن يحتاج طبقة وسيطة الأول.
  • مستوى الأمان والالتزام. الأدوار وسجلات المراجعة وتشفير الحقول الحساسة بتضيف مجهود لازم يتخطط له مش يتكتشف متأخر.
  • الوثائق والاختبار والتسليم. بتتقص كتير لتوفير الميزانية، وهي أول حاجة بتدفع تمنها بعدين.
  • التغيير المستمر. مزودي الـ APIs بيوقفوا نسخ قديمة، فالربط بيحتاج صيانة. اقرا اللي تتوقعه في دليل تكلفة صيانة المواقع.

إزاي تكتب طلب مشروع API

الطلب المفيد بيتكتب في صفحتين وبيجاوب على الأسئلة دي.

  1. إيه السيستمات الموجودة دلوقتي، ومين صاحب كل واحد؟
  2. إيه العمليات اللي عايزها تبقى أوتوماتيك بالظبط، وبحجم كام في اليوم أو الشهر؟
  3. مين هينادي على الـ API: موقعك، أبلكيشن موبايل، موظفين، شركاء؟ وكام من كل نوع؟
  4. إيه البيانات الحساسة، ومين مسموح له يشوفها؟
  5. إيه اللي لازم يحصل لما السيستم التاني يقع أو يرجع خطأ؟
  6. زمن الرد المقبول كام، وإيه أقصى حمل متوقع، زي بداية موسم أو حملة؟
  7. إيه الوثائق وبيئة الاختبار اللي المستخدمين هيحتاجوها؟
  8. مين هيصون النظام بعد الإطلاق، والتعديلات بتتطلب إزاي؟

اطلب من كل مورد بيئة تجريبية، وعينة من وثائق API لمشروع سابق، وشرح لإزاي بيتعامل مع إعادة المحاولة والتحقق من الهوية والنسخ. الموردين اللي بيبنوا APIs باستمرار بيجاوبوا في دقايق. والباقي هيجاوب بكلام عام.

ترتيب تسليم منطقي

مشاريع الـ API الكبيرة بتفشل لما كل حاجة تتحاول مرة واحدة. خطة على مراحل بتقلل المخاطرة.

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

أهداف الأداء والاعتمادية اللي تستاهل تتحدد

اتفق على أهداف تتقاس قبل ما التطوير يبدأ، واختبر عليها. من المفيد: زمن الرد لأهم endpoints القراءة عند النسبة 95، ونسبة الأخطاء المقبولة في الشهر، وخطوات الاسترجاع لما حاجة بتعتمد عليها تقع، وأقصى تأخير بين بيانات سيستمين. الطلبات الخارجية البطيئة لازم تشتغل في طوابير في الخلفية مش جوه طلب العميل، فتأخير عند مزود دفع أو ERP ميجمدش صفحة الدفع عندك. خزن اللي نادرا ما بيتغير، وارجع الحقول اللي الشاشة محتاجاها بس، وعمل فهارس في الداتا بيز للأعمدة اللي الـ endpoints بتفلتر بيها. دي قرارات هندسية عادية وهي اللي بتحدد إذا كان الربط هيحس إنه فوري ولا مش مضمون.

علامات حمرا في عرض API

خد بالك لو العرض مفيهوش ذكر لطريقة التحقق من الهوية، ولا خطة للنسخ، ولا بيئة اختبار، أو المفاتيح متخزنة في كود الواجهة، أو مفيش سجلات، أو التقدير فيه كلمة “API” كبند واحد من غير تفصيل الموارد والتكاملات. علامة تحذير تانية هي مورد بيبني الـ API جوه قالب الموقع نفسه، فالمنطق مش هيتستخدم تاني من أبلكيشن أو شريك. منطق الشغل مكانه طبقة أي واجهة تقدر تنادي عليها.

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

شارك:
مراجعة مجانية لموقعك

ابعتلنا موقعك وهنقولك إيه اللي معطّله على جوجل ومع الزوار.

مجاناً ومن غير أي التزام. بنبص على الصفحات اللي ظاهرة للناس بس، فمش محتاجين أي باسوورد.

المراجعة بتشمل إيه؟
لغة التقرير

التقرير بيوصلك على واتساب خلال يومين عمل

بتخطط لمشروعك الرقمي الجاي؟

قولنا أهدافك، وهنراجع احتياجاتك، ونرشحلك الطريقة المناسبة، ونبعتلك عرض سعر واضح. وبنرد خلال يوم عمل واحد.