تعتبر استدعاءات واجهة برمجة التطبيقات (API) في بايثون أدوات قوية مسؤولة عن التفاعلات بين الخدمات والتطبيقات عبر الإنترنت. في الأساس، توفر مجموعة من التعليمات والقواعد حول كيفية طلب المعلومات أو أداء الإجراءات على خدمة الويب.
ستسمح لك هذه المقالة بمعرفة سبب أهمية استدعاءات واجهة برمجة التطبيقات في بايثون، وتقدم لك بعض مقتطفات الشيفرة كمراجع.
إذا كنت مهتمًا بتعلم كيفية صياغة استدعاءات واجهة برمجة التطبيقات في بايثون، يمكنك تنزيل Apidog أولاً من خلال الضغط على الزر أدناه! 👇 👇 👇
قبل أن ننتقل مباشرة إلى استدعاءات واجهة برمجة التطبيقات في بايثون، دعنا نعزز معرفتنا باستدعاءات واجهة برمجة التطبيقات.
إعادة تسليط الضوء على ما هي استدعاءات واجهة برمجة التطبيقات
هناك اختلافات تقنية طفيفة بين استدعاء واجهة برمجة التطبيقات وطلب واجهة برمجة التطبيقات لا تجعل منهما متطابقتين تمامًا.
خصائص استدعاء واجهة برمجة التطبيقات:
- تشير إلى التفاعل الكامل بين برنامجين يستخدمان واجهة برمجة التطبيقات.
- عناصر متسقة مثل الطلب المرسل إلى واجهة برمجة التطبيقات، معالجته على الخادم، والاستجابة المستلمة.
- بطريقة ما، فإن استدعاءات واجهة برمجة التطبيقات هي الحزمة الكاملة - فهي جميع المحادثات التي يمكننا ملاحظتها بين البرامج.
خصائص طلب واجهة برمجة التطبيقات:
- تشير إلى الرسالة الأولية المرسلة من برنامج العميل إلى خادم واجهة برمجة التطبيقات.
- تحتوي طلبات واجهة برمجة التطبيقات على معلومات مثل طريقة HTTP، البيانات، وتفاصيل المصادقة.
- يمكنك التفكير في طلبات واجهة برمجة التطبيقات على أنها الأسئلة أو التعليمات المرسلة إلى الخادم لبدء المحادثة.
الآن بعد أن ناقشنا ما هي استدعاءات واجهة برمجة التطبيقات، دعنا ندخل في التفاصيل حول استدعاءات واجهة برمجة التطبيقات في بايثون.
استدعاءات واجهة برمجة التطبيقات في بايثون - عملية التفاعل
تشير استدعاءات واجهة برمجة التطبيقات في بايثون إلى عملية تفاعل كود بايثون الخاص بك مع واجهة برمجة التطبيقات لتبادل المعلومات وأداء الإجراءات.
العملية التفصيلية خطوة بخطوة لاستدعاء واجهة برمجة التطبيقات في بايثون
- تهيئة الكود: أولاً، أعد كود بايثون لإرسال طلب إلى نقطة نهاية واجهة برمجة التطبيقات المحددة باستخدام مكتبات (مثل
requests
وurllib
). - إرسال الطلب: يحدد هذا الطلب ما تريده من واجهة برمجة التطبيقات، على سبيل المثال:
طريقة HTTP: يمكن أن تسترجع طرقGET
البيانات، ويمكن أن تنشئ طرقPOST
شيئًا جديدًا.
البيانات: معلومات إضافية مطلوبة للإجراء، مثل البحث عن سجل معين، أو تصفية قاعدة بيانات. أمثلة على المعلومات الإضافية هي مصطلحات البحث وتفاصيل المستخدم. - استلام استجابة: يتلقى خادم واجهة برمجة التطبيقات طلبك ويقوم بمعالجته، ثم يرسل استجابة مرة أخرى إلى كودك. تتضمن هذه الاستجابة عادةً:
البيانات: المعلومات المطلوبة، مثل نتائج البحث أو رسالة تأكيد.
رمز الحالة: يشير إلى ما إذا كان الطلب ناجحًا (مثل 200 من أجل OK) أو واجه خطأ (مثل 404 من أجل غير موجود). - المعالجة: يتلقى كود بايثون الخاص بك الاستجابة، ويمكنه استخدام البيانات ضمن برنامجك.
فوائد استخدام استدعاءات واجهة برمجة التطبيقات في بايثون
- الوصول إلى البيانات و الوظائف: توفر واجهات برمجة التطبيقات وصولاً سهلاً إلى البيانات والوظائف من برامج أخرى، مما يوفر الوقت والجهد في التطوير. تصبح إمكانيات الوظائف التي يمكن لتطبيق بايثون الخاص بك القيام بها تقريبًا بلا حدود.
- دمج الخدمات: مثل النقطة أعلاه، يمكنك توصيل واجهات برمجة التطبيقات المختلفة باستخدام استدعاءات واجهة برمجة التطبيقات في بايثون. يمكنك إنشاء تطبيقات بايثون قوية مع ميزات تتجاوز ما يمكن أن يقدمه برنامج واحد.
- أتمتة المهام: يمكن لاستدعاءات واجهة برمجة التطبيقات في بايثون أتمتة المهام المتكررة ضمن تطبيق بايثون الخاص بك، مما يحسن الكفاءة ويقلل من العمل اليدوي.
أمثلة على الأماكن التي تلعب فيها استدعاءات واجهة برمجة التطبيقات في بايثون دورًا كبيرًا
- تطبيق الطقس: تتطلب استدعاءات واجهة برمجة التطبيقات في بايثون لاسترجاع بيانات الطقس في الوقت الفعلي من واجهات برمجة التطبيقات مثل OpenWeatherMap.
- تطبيقات وسائل التواصل الاجتماعي: يمكنك الاعتماد على استدعاءات واجهة برمجة التطبيقات في بايثون لتوصيل تطبيقك بواجهات برمجة التطبيقات الأخرى مثل تويتر API للوصول إلى البيانات. يمكنك بالتالي تحليل ما هو شائع، وإنشاء حملات تسويقية فعالة.
- قواعد البيانات العلمية عبر الإنترنت: قد تعتمد إنشاء مكتبة غنية مليئة بالمعلومات على استدعاءات واجهة برمجة التطبيقات في بايثون لتوصيل تطبيقك بالعديد من واجهات برمجة التطبيقات العلمية ذات الصلة. قد يشمل ذلك مجموعة NASA API لتوفير معلومات علمية حقيقية وموثوقة.
عينة كود لاستدعاء واجهة برمجة تطبيقات REST في بايثون
إليك عينة كود لعمل استدعاء إلى واجهة برمجة تطبيقات REST في بايثون (يرجى ملاحظة أن الكود هنا لا يجب نسخه مباشرة، حيث إنه هيكل يجب اتباعه وتعديله):
import requests # استبدل برابط واجهة برمجة التطبيقات الفعلي الخاصة بك، والرمز المميز، والبيانات api_url = "https://your-api.com/users" api_token = "YOUR_BEARER_TOKEN" user_data = { "name": "جون دو", "email": "johndoe@example.com", "password": "strongpassword123" } # تعيين رؤوس مع الرمز المميز headers = {"Authorization": f"Bearer {api_token}"} # إرسال طلب POST مع بيانات JSON response = requests.post(api_url, headers=headers, json=user_data) # التحقق من الاستجابة الناجحة if response.status_code == 201: # تم إنشاء المستخدم بنجاح، الوصول إلى بيانات الاستجابة new_user = response.json() print(f"تم إنشاء المستخدم: {new_user['name']} (ID: {new_user['id']})") else: # التعامل مع الخطأ print(f"خطأ في إنشاء المستخدم: {response.status_code} - {response.text}")
شرح الكود:
- أولاً، يقوم الكود باستيراد مكتبة
requests
. - ثم يحدد تفاصيل واجهة برمجة التطبيقات: استبدل العناصر النائبة بالقيم الفعلية الخاصة بك.
- بعد ذلك، يهيئ الرؤوس، والتي تتضمن الرمز المميز في رأس التفويض.
- يقوم بإرسال طلب POST باستخدام
requests.post()
، جنبًا إلى جنب مع الرابط، والرؤوس، وبيانات JSON. - ثم يتحقق من الاستجابة التي يتلقاها. إذا كانت ناجحة (201 تم إنشاؤها)، الوصول إلى بيانات الاستجابة وطباعة التفاصيل الجديدة للمستخدم.
- في حال عدم استلامه رمز الحالة الصحيح، فإنه يتعامل مع الأخطاء ويقوم بطباعة رمز الحالة والرسالة الخاصة بالخطأ.
Apidog - لم يكن إنشاء استدعاءات واجهة برمجة تطبيقات بايثون أسهل من قبل!
Apidog هي منصة لتطوير واجهة برمجة التطبيقات تركز على التصميم، مما يسمح للمستخدمين بتوليد لغات عميل متنوعة خلال بضع ضغطات على الأزرار! لا تجرب فقط حفظ الوقت والجهد الثمين، ولكنها أيضًا تتيح للمطورين عدم القلق بعد الآن حول ما إذا كان الكود الذي يستخدمونه يمكن أن يعمل أم لا!
لتوصيل تطبيق بايثون الخاص بك، لنبدأ بتوليد كود بايثون لإنشاء طلب بايثون، حتى تتمكن من بدء استدعاء واجهة برمجة التطبيقات في بايثون.
توليد كود بايثون لطلب باستخدام Apidog
أولاً، حدد هذا الزر الصغير </>
الموجود حوالي الزاوية العلوية اليمنى من نافذة Apidog.
وهكذا حصلت عليه! كل ما عليك فعله هو إضافة الكود إلى ملف بايثون الخاص بك، وإضافة أي تخصيصات المطلوبة حتى يعمل!
الخاتمة
لبدء التعلم حول كيفية إجراء استدعاءات واجهة برمجة التطبيقات في بايثون، تأكد من أنك قد قمت بتنزيل البرمجيات والمكتبات اللازمة على جهازك. تعتبر استدعاءات واجهة برمجة التطبيقات في بايثون أصولًا مفيدة جدًا لمطوري التطبيقات، حيث تمكنهم من الاتصال بأنواع مختلفة من الخدمات وقواعد البيانات. باستخدام استدعاءات واجهة برمجة التطبيقات في بايثون، يمكنك إنشاء أي شيء من خيالك!
بصرف النظر عن مجرد توليد كود العميل، يمكن لـ Apidog أيضًا إنشاء طلبات POST في بايثون. نظرًا لأن Apidog هي أداة تطوير واجهة برمجة التطبيقات الشاملة، يمكنك بناء واختبار ومحاكاة وتصحيح واجهة برمجة التطبيقات الخاصة بك، أو حتى تعديل واجهات برمجة التطبيقات الخاصة بمطورين آخرين تعتقد أنها مثيرة للاهتمام أو رائعة. جرب Apidog بسرعة اليوم - فهو مجاني!