تعديل المشاركة

واجهة برمجة التطبيقات (API) تعريفها - استخداماتها

عبدالجليل الولي
(0)
واجهة برمجة التطبيقات (API) تعريفها - استخداماتها


ربما تكون قد سمعت عن مصطلحات API أو واجهة برمجة التطبيقات العامة أو واجهة برمجة تطبيقات الويب. غالبًا ما يستخدمه صانعو البرامج عند الحديث عن التطبيقات / أنظمة التشغيل / مواقع الويب. ولكن هل تساءلت يومًا عن ماهية واجهة برمجة التطبيقات أو كيفية استخدامها؟

ما هي API؟

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

تسمح واجهات برمجة التطبيقات للمطورين بإجراء "مكالمات" أو "طلبات" لإرسال واستقبال المعلومات. يتم هذا الاتصال باستخدام لغة برمجة تسمى "JSON". يمكن استخدامه أيضًا لتنفيذ إجراءات معينة مثل تحديث البيانات أو حذفها. هناك أربع طرق طلب أساسية يمكن إجراؤها باستخدام واجهة برمجة التطبيقات.
  1. الجلب/ الاستخراج- اجمع المعلومات (استخرج جميع أكواد القسائم).
  2. إضافة- تحديث جزء من البيانات (تحديث سعر المنتج)
  3. إنشاء- إنشاء (إنشاء فئة منتج جديدة)
  4. حذف- (حذف المنشور)

إذن ما هو JSON ولماذا يتم استخدامه؟

يتم استخدام JSON (JavaScript Object Notation) لتمثيل البيانات على الخادم. يسهل على البشر قراءته ويسهل على الآلات/ التطبيقات فهمه. لنلقي نظرة على مثال JSON لمنتج على موقع BigCommerce الخاص بنا.
JSON

كما ترى ، من السهل فهم الكود أعلاه حيث يتم تقديمه كزوج ذي قيمة مفتاح مع المفتاح على اليسار والقيمة على اليمين. المفتاح هو كائن ثابت يحدده التطبيق وسيظل "فئة". على الرغم من أن القيمة ستكون فريدة ، مثل "Shirts".

ما هي طلبات API؟

يحتوي طلب API الخاص به للعمل على العديد من المكونات. دعنا نتصفحها واحدة تلو الأخرى لنفهم كيف يمكن استخدامها لبناء الطلب.

نقطة نهاية الاتصال

هناك جزءان رئيسيان لنقاط النهاية المستخدمة عند إجراء طلبات API.
  1. واحد هو رابط URL. استخدم BigCommerce                                                                                          استخدم https://api.bigcommerce.com/stores كعنوان URL لجميع طلبات واجهة برمجة التطبيقات. يبدو هذا كأنه عنوان URL عادي ، ولكن عندما أضعه في متصفح ويب ، تظهر لي رسالة خطأ 404.
  2. الجزء 2 هو المسار. هناك مسارات مختلفة حسب ما تحاول تحقيقه. [يمكنك العثور على قائمة بالمسارات المتاحة لـ BigCommerce من خلال زيارة وثائق المطور].                                                                                        ومع ذلك ، في هذا المثال، سنستخدم مسار المنتج وهو: v3/catalog/products
الجمع بين الجزأين يعطينا نقطة نهاية اتصال كاملة.
   https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products.

قد تسأل "ما هو {store_hash}؟ من أين أتت؟"
يُعرف هذا باسم "المتغير". المتغيرات هي مكونات فريدة لنقاط النهاية وتعتمد على معلومات المتجر. يمكن تحديد المتغيرات بوضعها بين قوسين "{}".

الترويسة Header

توفر الرؤوس معلومات للعملاء والخوادم. الأمثلة الشائعة لرؤوس اعتماد المصادقة هي رموز المصادقة أو معرفات العميل. تتوفر بيانات الاعتماد هذه تلقائيًا عند إنشاء حساب API.
نوع المحتوى هو رأس شائع آخر يخبر الخادم بنوع المحتوى الذي تم إرساله. على سبيل المثال ، أحد أنواع المحتوى الشائع الاستخدام هو "application / json". يتيح هذا للخادم معرفة أنك ترسل بيانات JSON.
 
الطريقة Method
الطريقة هي إجراء يتم تنفيذه عند إرسال طلب. هل تتذكر عندما تحدثنا لأول مرة عن (GET و PUT و POST و DELETE)؟ هذه كلها طرق API.
 
البيانات Data
بيانات الطلب ، وتسمى أيضًا "الهيكل" ، هي المعلومات التي يرسلها / يسترجعها الخادم. يمكنك مشاهدة مثال لبيانات API في مناقشة JSON أعلاه. قد يتطلب هيكل طلبك معلومات معينة قبل التسليم. على سبيل المثال ، عند تحرير منتج ما ، فإنك تحتاج إلى معرف المنتج قبل إجراء التغييرات.

ماذا عن واجهات برمجة تطبيقات REST & SOAP؟

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

REST ، والتي تعني نقل الحالة التمثيلية ، هي مجموعة من القواعد التي يتبعها المطورون عند إنشاء واجهات برمجة التطبيقات. تتمثل إحدى هذه القواعد في أنه يجب تصميم واجهات برمجة التطبيقات بطريقة منطقية وسهلة الاستخدام لمطوري الويب. مثال على انتهاك هذه القاعدة هو جعل نقطة نهاية المنتج "prod_839" بدلاً من "product".

SOAP أو "Simple Object Access Protocol" هو نموذج تصميم آخر لخدمات الويب. بدلاً من بناء جملة JSON الشائع الذي تستخدمه REST APIs. يستخدم SOAP لغة تعرف باسم لغة التوصيف الموسعة (XML). تم تصميمه ليكون قابلاً للقراءة آليًا وبشرًا. يتبع SOAP معيارًا من الاصطلاحات القوية ، بما في ذلك هياكل المراسلة والاتفاقيات لإرسال الطلبات أو الردود.

بشكل عام ، تشير هذه المقالة إلى معايير REST API الشائعة في عالم اليوم. تستخدم الشركات الكبيرة مثل Google و Amazon و eBay واجهات برمجة تطبيقات REST. عادةً ما يكون REST هو الخيار المفضل بين مطوري البرامج.

أمثلة API اليومية

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

الذهاب الى البنك

فكر في نفسك (المستخدم) ، وصراف البنك (API) ، ومدير البنك (النظام الذي تتفاعل معه).

عندما تريد سحب بعض الأموال من حسابك ، انتقل إلى الصراف (API) وقل ، "أريد 1000 دولار من هذا الحساب".
لذلك يعود الصراف (API) ويخبر مدير البنك (النظام) ، "مستخدم السيد / السيدة يريد 1000 دولار."
يقوم مدير البنك (النظام) أخيرًا بإبلاغ المبلغ إلى الصراف (API).
كماترى،فـان API مجرد رسول بين احتياجاتك والنظام.

البحث عن الفنادق

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

البحث عن الملفات الشخصية على Facebook

مطاردة حبيبتك السابقة؟ آمل ألا! ولكن بفضل واجهة برمجة التطبيقات الخاصة بنا ، يمكنك القيام بذلك بسهولة ، فعندما تكتب "John Smith" على Facebook ، تخبر API خادم Facebook أنه يبحث عن John Smith. سيرسل لك Facebook بعد ذلك قائمة بجميع الملفات الشخصية التي تطابق هذا الاسم (بما في ذلك عوامل مثل قربك وأصدقائك المشتركين). يمكنك العثور على John Smith!

البحث عن مطعم جديد

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

ابق على اطلاع بأحدث الأخبار على الشبكات الاجتماعية

أنت عالق في سيارة أجرة في حركة المرور في ساعة الذروة. لا شيء أسوأ من ذلك ، أعلم!

قررت أن آخذ إجازة لبعض الوقت وأتابع ما كان يحدث في عالم الرياضة. افتح Twitter وانتقل إلى قسم الرياضة. تتيح لك واجهة برمجة تطبيقات Twitter عرض مجموعة متنوعة من التغريدات المتعلقة بفريقك المفضل الذي فاز في التصفيات. يمكنك حتى إعادة تغريد نتيجتك النهائية لمضايقة أصدقائك الذين خسر فريقهم. من هنا ، يعرف Twitter أنه يجب أن يأخذ هذه التغريدة ويعرضها على كل من يتابعك.

لماذا تستخدم المتاجر الحديثة على الإنترنت واجهات برمجة التطبيقات؟

تجلب واجهات برمجة التطبيقات العديد من الفوائد لمتجرك عبر الإنترنت. إنه يساعد المستهلكين في العثور على منتجاتك بسهولة ، وتنمية العلامة التجارية لشركتك ، وتوسيع إمكانات إيراداتك عن طريق بيع منتجاتك في أسواق مختلفة مثل eBay و Amazon و Facebook. فيما يلي بعض الفوائد التي تثبت أهمية واجهات برمجة التطبيقات في المتاجر عبر الإنترنت اليوم.

الأمان

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

السرعة

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

قابلية التوسع

تمنحك واجهات برمجة التطبيقات قابلية التوسع والمرونة أثناء تطوير كتالوج متجرك أو درجة الأمان أو احتياجات البيانات. يمكن أن ينمو متجرك بمعدل أسرع إذا لم يكن عليك تضمين رمز جديد لكل منتج أو مستخدم. 

انواع API المستخدمه

هناك (3) أنواع من واجهات برمجة التطبيقات شائعة الاستخدام اليوم.
  1. واجهة برمجة التطبيقات المفتوحة (Open API)
  2. واجهة برمجة تطبيقات للشركاء (Partner API)
  3. واجهة برمجة تطبيقات الشخصية (Private API)
Open APIs عامة ومتاحة لأي شخص لاستخدامها. على سبيل المثال ، يستخدم BigCommerce حوالي 25 واجهة برمجة تطبيقات مختلفة متاحة للجمهور.

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

تم تصميم واجهات برمجة التطبيقات الشخصية للاستخدام الداخلي. لنفترض أنك تسافر إلى مدينة أخرى لحضور اجتماع عمل. أنا بحاجة للذهاب إلى البنك على الفور. اذهب إلى "Lorem Ipsum Bank" وأعط رقم الحساب للصراف. يقوم الصراف بإدخال رقم الحساب بسرعة وإكمال السحب.

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

واجهات برمجة تطبيقات المتاجر الإلكترونية المشتركة

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

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

خاتمة

تعد واجهات برمجة التطبيقات أدوات قوية لتسريع نمو الأعمال ، وتوسيع نطاق الوصول إلى العلامة التجارية ، وربط المتسوقين بالمنتجات التي يحتاجون إليها ، والمزيد. هل تريد أن تعرف كيف يمكن أن تساعد واجهات برمجة التطبيقات في دعم عملك؟ فيما يلي بعض الموارد الإضافية:
  • توفر وثائق مطور API إرشادات حول الميزات المتنوعة المتاحة.
  • يساعدك متجر تطبيقات Big Commerce على الاتصال بخدمات مثل Google Shopping ، والنسخ الاحتياطي السريع للبيانات المهمة باستخدام Rewind ، وإنشاء صفحات ويب مخصصة جميلة باستخدام أدوات مثل Shogun.
  • أخيرًا ، يوصلك BigCommerce Partner Directory بالعديد من الشركاء المعتمدين الذين هم على دراية بواجهة برمجة تطبيقات متجرك وقد يساعدك في العثور على الحل المخصص المثالي لعملك.
مصادر:
What is an API? A Digestible Definition with API Examples for Ecommerce Owners


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

أخر المواضيع من قسم : شروحات

تعليقات

إرسال تعليق

التنقل السريع