Menu
Coddy logo textTech
flag Ar iconالعربيةdown icon

requests Method to Send Data

الدرس 6 من 10 في دورة API في Python على Coddy.

تماماً مثل استرداد البيانات باستخدام طلبات GET، يمكننا إرسال البيانات إلى خادم API باستخدام طريقة .post().

تتطلب طريقة post() عنوان URL وتتضمن عادةً ترويسات (headers) وبيانات كوسطاء. المبدأ هو أن بياناتك سيتم إرسالها إلى نقطة نهاية API، وسيقوم الخادم بمعالجتها.

يبدو هيكل كود post() كما يلي:

import requests
response = requests.post(
	"https://api.example.com/endpoint",
	headers={
		"Content-Type": "application/json"
	},
	json={
		"key1": "value1",
		"key2": "value2"
	}
)

يتم تمرير الترويسات والبيانات كقواميس (dictionaries) مع أزواج المفتاح والقيمة الخاصة بها.

ملاحظة:

  • تتضمن الترويسات عادةً بيانات وصفية (metadata) حول طلبك (مثل نوع المحتوى)
  • يقوم معامل json تلقائياً بتحويل قاموس Python الخاص بك إلى تنسيق JSON
  • تتطلب بعض واجهات برمجة التطبيقات (APIs) مصادقة عبر مفاتيح API في الترويسات
challenge icon

التحدي

متوسط

أرسل طلب POST لإنشاء مستخدم جديد باستخدام JSONPlaceholder API.

التعليمات:

أرسل طلب POST إلى: https://jsonplaceholder.typicode.com/users

قم بتضمين الترويسة التالية:

{"Content-Type": "application/json"}

أرسل البيانات التالية باستخدام المعامل json:

{
    "name": "James Shelby",
    "email": "jamesshelbys1987@example.com",
    "username": "jshelby1987"
}

احفظ كائن requests.post() في متغير يسمى response

اطبع كلاً من response.status_code و response.json() لرؤية النتيجة

المخرجات المتوقعة: يجب أن تتلقى رمز حالة 201 (Created) وترى بيانات المستخدم الخاصة بك معرّفة بمعرف (ID) معين!

جرّب بنفسك

import requests

response = requests.post(
    # Your code here
)

print("Status Code:", response.status_code)
print("Response:", response.json())

جميع دروس API في Python