كيف تعمل واجهة برمجة التطبيقات؟ كيفية دمج API في التطبيق

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

غالبًا ما ترسل واجهات برمجة التطبيقات (APIs) بيانات معقدة كردود، فكيف يمكنك فهم هذه المعلومات واستخدامها لخدمة المستخدمين؟ تجعل واجهات برمجة التطبيقات الحياة سهلة لكل من المطورين ذوي الخبرة وأولئك الذين بدأوا للتو. لذلك عليك أن تعرف كيفية استخدامها مع التطبيق الخاص بك.

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

ما هي واجهة برمجة التطبيقات؟

توفر واجهات برمجة التطبيقات طريقة للبرامج المنفصلة للتفاعل مع بعضها البعض

توفر واجهات برمجة التطبيقات طريقة للبرامج المنفصلة للتفاعل مع بعضها البعض. تحدد واجهات برمجة التطبيقات الطلبات التي يمكن إجراؤها، وكيفية تقديم الطلبات، وتمكين تبادل البيان��ت بين تطبيقات البرامج المختلفة.

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

كيف تعمل واجهة برمجة التطبيقات؟

يقوم المطورون بإنشاء واجهات برمجة التطبيقات (APIs) كمنتجات يمكنها خدمة المطورين الآخرين. الهدف هو جعل عمليات تطوير الويب المعقدة أسهل وأكثر كفاءة وأسرع للمطورين المستهلكين أو الشركات.

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

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

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

كيف يتم استخدام واجهة برمجة التطبيقات؟

يتم استخدام واجهات برمجة التطبيقات في كثير من الحالات

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

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

ما هي نقطة نهاية API؟

يتطلب الاتصال بواجهة برمجة التطبيقات (API) توصيل برنامجك بنقطة نهاية واجهة برمجة التطبيقات (API). يمكنك التفكير في هذا كاتصال ثنائي الاتجاه. ترسل نقطة النهاية المتصلة ببرنامجك الطلب، بينما ترسل لك نقطة النهاية المتصلة بواجهة برمجة التطبيقات استجابة محددة.

نقطة النهاية هي عنوان URL للطلب وتوفر للعميل إمكانية الوصول المباشر إلى موارد واجهة برمجة التطبيقات.

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

معايير الاتصال بـ API

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

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

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

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

للاتصال بأي واجهة برمجة تطبيقات، تحتاج أيضًا إلى معرفة لغات البرمجة التي تدعمها.

كيفية الاتصال بواجهة برمجة التطبيقات (API): مثال عملي

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

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

كيفية استخدام Iro.Js Color Picker API

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

التوثيق الكامل لواجهة برمجة التطبيقات هذه متاح على iro.js.org:

https://iro.js.org/guide.html

دعونا نرى كيف يمكنك الاتصال بواجهة برمجة التطبيقات هذه باستخدام نموذج التعليمات البرمجية أدناه:

Display color picker

في حالة نموذج واجهة برمجة التطبيقات أعلاه، لا تحتاج إلى مفتاح واجهة برمجة التطبيقات للاتصال به. ومع ذلك، لفهم أفضل، دعونا نلقي نظرة فاحصة على جافا سكريبت. للاتصال بواجهة برمجة التطبيقات هذه، ما عليك سوى استدعاء وظيفة ColorPicker من فئة iro ، ثم تمرير معرف حاوية عجلة الألوان إلى الفئة.

من السهل الاتصال بنقطة نهاية iro.js API، حيث قام مطوروها بالعمل الإضافي المتمثل في ترميز الطبقة للمستخدمين. الصورة أدناه هي نتيجة رمز المثال أعلاه.

نتيجة رمز المثال

لمعرفة كيفية حدوث حدث تغيير اللون، يمكنك فتح ملف HTML آخر ولصق الكود التالي في قسم البرامج النصية الخاص به :

var colorPicker = new iro.ColorPicker('#color-pick', {
   // Set the size of the color picker
   width: 400,
   // Set the initial color to pure red
   color:"#ff0000"
 });
const myColor =(color)=>{
	console.log(color.hexString);
};
colorPicker.on("color:change", myColor);

يسجل الكود أعلاه قيم الألوان السداسية العشرية في كل مرة تقوم فيها بتغيير موضع منتقي الألوان على العجلة.

كيفية استخدام واجهة برمجة تطبيقات صرف العملات NoCodeAPI

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

https://app.nocodeapi.com/login

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

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

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

راجع رمز المثال أدناه لتحويل العملة: