كيفية إجراء طلب PUT في بايثون مع الرؤوس

هل تساءلت يومًا كيف يمكنك تحديث البيانات على خادم الويب باستخدام بايثون؟ إذا كان الأمر كذلك، أنت لست وحدك. يكافح العديد من المطورين مع مفهوم طلبات PUT، وهي واحدة من أكثر الطرق شيوعًا في بروتوكول HTTP. تتيح لك طلبات PUT إرسال البيانات إلى خادم ويب واستبدال المورد الموجود بالآخر الجديد. يبدو الأمر بسيطًا، أليس كذلك؟

في هذه التدوينة، سنغطي أساسيات واجهات برمجة التطبيقات (APIs)، طلبات HTTP، وطلبات PUT. سنوضح لك أيضًا كيفية استخدام مكتبة requests لإجراء طلب PUT في بايثون مع الرؤوس واختباره باستخدام Apidog.

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

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

ما هو طلب HTTP؟

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

هناك طرق HTTP متنوعة، تُعرف أيضًا بطلبات HTTP، كل منها يخدم غرضًا مميزًا وينقل طبيعة الطلب. تشمل طرق HTTP الأكثر شيوعًا GET، POST، PUT وDELETE.

ما هو طلب PUT؟

طلب PUT هو طريقة طلب HTTP تُستخدم لتحديث أو استبدال مورد موجود على الخادم. ينشئ طلب PUT موردًا جديدًا أو يستبدل تمثيل المورد المستهدف بحمولة الطلب. يحتوي الطلب على جسم والرد الناجح يحتوي على جسم. طلب PUT ليس آمنًا ويعتبر متكرراً. لا يُسمح به في نماذج HTML.

ما هي الرؤوس؟

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

لماذا من المناسب استخدام بايثون لإرسال طلبات PUT مع الرؤوس؟

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

تجعل مكتبات بايثون الواسعة منها المفضلة لدى المطورين، كما أن تركيبها يضمن أن المبتدئين يمكنهم فهم مفاهيمها بسرعة. لذلك، لماذا لا نستفيد من قوة بايثون لجعل طلبات PUT مع الرؤوس أسهل من أي وقت مضى؟

كيفية إجراء طلب PUT في بايثون مع الرؤوس

الآن بعد أن تناولنا أساسيات واجهات برمجة التطبيقات، طلبات HTTP، طلبات PUT، والرؤوس، دعنا نتعمق في كيفية إجراء طلب PUT في بايثون مع الرؤوس. في بايثون، يمكنك إجراء طلب PUT مع الرؤوس باستخدام مكتبة requests، وهي مكتبة HTTP شهيرة لإجراء طلبات HTTP. إذا لم تكن مثبتة، يمكنك تثبيتها باستخدام:

pip install requests

إليك أمثلة عن كيفية إجراء طلب PUT في بايثون مع الرؤوس بأنواع محتوى وصيغ بيانات مختلفة.

1. طلب PUT في بايثون مع بيانات JSON:

import requests
import json

url = 'https://api.example.com/data'
headers = {'Content-Type': 'application/json'}
data = {'key1': 'value1', 'key2': 'value2'}

response = requests.put(url, headers=headers, data=json.dumps(data))
print(response.status_code)
print(response.json())

في هذا المثال، نجري طلب PUT إلى URL المحدد مع بيانات JSON. نحن نضبط رأس 'Content-Type' إلى 'application/json' لتحديد صيغة البيانات.

1. طلب PUT في بايثون مع بيانات النموذج:

import requests

url = 'https://api.example.com/data'
headers = {'Content-Type': 'application/x-www-form-urlencoded'}
data = {'key1': 'value1', 'key2': 'value2'}

response = requests.put(url, headers=headers, data=data)
print(response.status_code)
print(response.text)

في هذا المثال، نجري طلب PUT مع بيانات النموذج. نحن نضبط رأس 'Content-Type' إلى 'application/x-www-form-urlencoded' لتحديد صيغة البيانات.

1. طلب PUT في بايثون مع بيانات XML:

import requests

url = 'https://api.example.com/data'
headers = {'Content-Type': 'application/xml'}
data = '<xml><key1>value1</key1><key2>value2</key2></xml>'

response = requests.put(url, headers=headers, data=data)
print(response.status_code)
print(response.text)

في هذا المثال، نجري طلب PUT مع بيانات XML. نحن نضبط رأس 'Content-Type' إلى 'application/xml' لتحديد صيغة البيانات.

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

فهم طلب PUT مع الرؤوس في بايثون.

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

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

استخدام Apidog لاختبار طلب PUT الخاص بك في بايثون مع الرؤوس

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

إليك كيفية استخدام Apidog لاختبار طلب PUT الخاص بك مع الرؤوس:

1. افتح Apidog وأنشئ طلبًا جديدًا.

2. اضبط طريقة الطلب على PUT.

3. أدخل عنوان URL للمورد الذي تريد تحديثه. أضف الرؤوس والمعلمات الإضافية التي ترغب في تضمينها ثم انقر على زر "إرسال" لإرسال الطلب.

4. تحقق من أن الاستجابة هي كما توقعت.

أفضل الممارسات لإجراء طلب PUT في بايثون مع الرؤوس

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

1. أولاً، يجب دائمًا تضمين معالجة الأخطاء المناسبة في رمزك لضمان عدم تعطل برنامجك عند حدوث خطأ. يمكنك استخدام تعابير try وexcept للتعامل مع الأخطاء في بايثون. على سبيل المثال، يمكنك التقاط جميع الاستثناءات باستخدام الاستثناء الأساسي Exception أو التقاطها بشكل منفصل والقيام بأشياء مختلفة.

2. ثانيًا، تتطلب بعض النقاط النهائية المصادقة باستخدام الرؤوس أو الرموز أو بيانات اعتماد المستخدم. تأكد من أن طلبك يتضمن ذلك عند الحاجة. يمكنك استخدام معامل auth في مكتبة requests لتوفير بيانات اعتماد المصادقة. على سبيل المثال، يمكنك استخدام المصادقة الأساسية مع فئة HTTPBasicAuth المقدمة من مكتبة requests. إذا كنت تصل إلى عنوان URL يتطلب مصادقة Windows، يمكنك استخدام مكتبة Requests-NTLM.

3. ثالثًا، عند إجراء طلب PUT، تأكد من إرسال البيانات بشكل آمن. إذا كنت ترسل بيانات عبر HTTP، يُوصى باستخدام HTTPS بدلاً من ذلك. يمكنك التحقق من صلاحية شهاԴة أمانك عن طريق تنفيذ openssl s_client -showcerts -connect example.com:443 من سطر الأوامر والتحقق من أنه يُبلغ عن رمز إرجاع التحقق: 0 (حسنًا). يمكنك أيضًا تعطيل فحص شهادة الأمان في طلبات Python باستخدام مدير السياق الذي يقوم بتعديل requests بحيث يصبح verify=False هو الإعداد الافتراضي ويقوم بإسكات التحذير.

الخاتمة

في هذه التدوينة، تناولنا كل ما تحتاج لمعرفته حول إجراء طلب PUT في بايثون مع الرؤوس. ناقشنا أساسيات واجهات برمجة التطبيقات، طلبات HTTP، وطلبات PUT. كما أظهرنا لك كيفية استخدام مكتبة requests لإجراء طلب PUT في بايثون مع الرؤوس وكيفية اختبار طلب PUT الخاص بك باستخدام Apidog.