PUT

طريقة PUT PUT

تستبدل المورد بالكامل بالبيانات المُرسلة.

PUT idempotent: تكرار نفس الطلب بنفس البيانات ينتج نفس النتيجة النهائية، لأنها لا تُضيف موردًا جديدًا بل تستبدل الموجود. تحمل جسم الطلب كاملًا — أي حقل لا تُرسله يُعامَل غالبًا كأنه غير موجود بعد التحديث.

هذا يختلف جوهريًّا عن PATCH التي تُعدّل جزءًا فقط.

الصياغة

PUT /users/1 HTTP/1.1
Host: example.com
Content-Type: application/json

{"name": "Ali", "age": 30}

📄 مثال

curl -X PUT -H "Content-Type: application/json" -d '{"name":"Ali","age":30}' https://api.example.com/users/1

أهم النقاط

العنصر	الوظيفة
Idempotent	تكرار الطلب بنفس البيانات ينتج نفس النتيجة
استبدال كامل	يستبدل المورد بأكمله لا جزءًا منه

💡 نصائح عملية

أرسل كل حقول المورد مع PUT حتى لا تفقد بيانات لم تذكرها

⚠️ أخطاء شائعة

إرسال حقول ناقصة معتقدًا أن PUT تُحدّث جزئيًا — PUT تستبدل الكل، فتُفقد الحقول غير المُرسلة

🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار NETWORKING الكامل بالعربي.