29/10/2020
#ماهو الـ API ؟
اختصاراً لـ Application Programming Interface (واجهة برمجة التطبيقات) او (واجهة التواصل بين التطبيقات), هي واجهة حوسبة تحدد التفاعلات بين العديد من البرامج والمنظومات وتطبيقات المحمول .
#ماهو الـ Rest API؟
اختصاراً لـ Representational state transfer مبني على طريقة توافق مبدأ الـ Webservice من احد انواع الـ API وسميت بهذا الاسم نظراً لانها وسيلة لنقل المعلومات بين الـ Server و Client عن طريق بروتوكلات الـ HTTP, فجميع العمليات تتم من خلال هذه البروتوكولات باختلاف انواعها ومبادئها, يتكون الـ Rest API من مجموعة من الخدمات وكل واحد منها يعمل بشكل منفصل ويمكنها الارتباط لتعمل كمجموعة واحدة.
#ماهو الـ HTTP Protocols :-
الـ HTTP لديه بعض البروتوكلات او الدوال تصف نوع الطلب المرسل الى السيرفر, واذا اردت جلب بعض المعلومات من السيرفر يجب ان تستخدم البروتوكول او الدالة GET اما اذا اردت اضافة بيانات جديدة فاستخدم بروتوكولPOST , هذه الدوال تستخدم مع كل طلب يتم ارساله للسيرفر, والدوال المستخدم هي اربعة:
GET لجلب عناصر من السيرفر (للعرض)
POST لإضافة عناصر جديدة (إضافة)
PUT لتعديل على عنصر (التعديل)
DELETE لحذف عنصر من المصدر (الحذف)
#طريقة عمل الـ API :-
التواصل بين السيرفر والعميل يكون عن طريق امرين Request و Response, الاول الـ Request هو الامر الصادر من الـ Client يمكن ان يكون صفحة ويب او تطبيق سطح مكتب او غيرها وكل امر او طلب يتكون من عدة امور:
- الرابط الخاص بالـ Service الموجود على السيرفر (الرابط URL).
- البروتوكول المطلوب. (GET , POST)
- متغيرات او بيانات يجب ارسالها الى السيرفر. (Parameters)
سيستقبل السيرفر هذا الامر ويقوم بتحليله وعمل بعض العمليات بناء على طريقة برمجته ومن ثم بقوم بارجاع جواب Response يحتوي على كود الحالة .
#كود الحالة HTTP Status Code :
وكل رقم يدل على امر معين, فبعض الارقام تدل على ان الطلب من العميل كان مقبول وتم ارجاع بيانات صحيحة
وبعضها تدل على ان الطلب من العميل صحيح ولكن لم يتم يستطع السيرفر معالجة البيانات مثلا :
- حالة رقم 200 - تم قبول الطلب
- حالة رقم 400 - خطا في الادخال
-حالة رقم 401 - غير مصرح
وبعض المعلومات الخاصة بالـ Header والتي توضح بعض المعلومات عن السيرفر وعن المعلومات التي سيتقوم السيرفر بارجاعها.
البيانات التي طلبها الـ Client وتكون بصيغة JSON.
#الهدف من الـ API :-
هى نقطة الوصل بين بيئة تطويرية معينة والمطورين , حتى تتيح لهؤلاء المطورين الاستفادة من خدامات هذه البيئة بدون الحاجة إلى بناء كل شئ من الصفر ومن اهم الامثلة :-
- الفيسبوك يتيح API للمواقع لتسجيل الدخول عن طريقه بدون الحاجة إلى بناء نظام تسجيل دخول من الصفر .
- جوجل Google Maps التى تسمح للمطورين بعرض اجزاء من خرائط معينة على مواقعهم الالكترونية اوعلى تطبيقات المحمول .
#امثله عن API المجانية :-
https://rapidapi.com/marketplace
يحتوي على مجموعة من API الخدمية .
#وايضا API من شركة سودو مثال مبسط لعملية الادخال والحذف ويمكنك الاطلاع عليه على :-
app.sudo.ly/api/item-api
#ومن افضل البرامج التي يتم استخدامها على API :
PostMan - postman.com
Insomnia - insomnia.rest
#واما تطبيقات المحمول التي يتم استخدامها على API :
HTTPbot - Apple store
Rest Client - Play store
المصادر :
-wikipedia
-stoplight.io
-.ws-it.com
#للاستفسار اكتر
☑️ يمكنك التواصل معنا على:
شــــركة ســـــــــودو للاتصالات والتقنية
طريــــــــــق النـــــــــــــــهر - الهـــــــــــواري
هاتف : 0614701892 - 0925311995
بريـد الاكــــــــــــــتروني : [email protected]
الموقع الاكـــــــــتروني : sudo.ly
