مكتبة Requests هي مكتبة برمجية للغة Python تساعدك في إرسال طلبات HTTP بسهولة وبساطة. توفر هذه المكتبة واجهة برمجة التطبيق (API) لإجراء طلبات GET وPOST وPUT وDELETE وغيرها من طرق HTTP.
لبدء استخدام مكتبة Requests، يجب تثبيتها أولاً على جهاز الكمبيوتر الخاص بك. يمكنك تثبيتها باستخدام أداة إدارة حزم Python المفضلة لديك، مثل pip، باستخدام الأمر التالي:
pip install requests
بمجرد تثبيت المكتبة، يمكنك البدء في استخدامها في برنامجك. فيما يلي بعض الأمثلة التفصيلية لكيفية استخدام مكتبة Requests:
1. إرسال طلب GET:
لإرسال طلب GET بواسطة Requests، يجب تمرير عنوان URL المستهدف إلى الدالة get().
pythonimport requests
response = requests.get('https://api.example.com/users')
print(response.status_code) # يطبع رمز حالة الاستجابة (مثلاً 200 للاستجابة الناجحة)
print(response.json()) # يطبع بيانات الاستجابة المستلمة بتنسيق JSON
2
. إرسال طلب POST:
لإرسال طلب POST، يمكنك استخدام الدالة post() وتمرير البيانات المطلوبة كوسيطة.
pythonimport requests
data = {'username': 'example_user', 'password': 'secretpassword'}
response = requests.post('https://api.example.com/login', data=data)
print(response.status_code)
print(response.json())
3. تمرير معلومات في الطلب بصورة أكثر تفصيلاً:
يمكنك تعيين معلمات إضافية مثل الرؤوس (headers) أو البيانات المرسلة (payload) في الطلبات.
pythonimport requests
headers = {'Authorization': 'Bearer my_token'}
params = {'page': 2, 'per_page': 10}
response = requests.get('https://api.example.com/users', headers=headers, params=params)
print(response.status_code)
print(response.json())
هذه أمثلة بسيطة لاستخدام مكتبة Requests في Python. توفر المكتبة المزيد من الوظائف والخيارات للتعامل مع طلبات HTTP المتقدمة، مثل التعامل مع رؤوس الطلب والاستجابة، وإجراء طلبات PUT وDELETE، والتعامل مع محتوى الاستجابة بصيغ مختلفة (مثل JSON وXML وغيرها).
للمزيد من المعلومات حول استخدام مكتبة Requests، يمكنك زيارة موقع الوثائق الرسمي للمكتبة على الرابط التالي: https://docs.python-requests.org/