PATCH
طريقة PATCH PATCH
تُعدّل جزءًا من المورد فقط دون استبداله بالكامل.
PATCH تحمل في جسم الطلب الحقول المطلوب تغييرها فقط، وباقي حقول المورد تبقى كما هي. المعيار الرسمي لا يضمن أنها idempotent دائمًا، لكن أغلب الـ APIs العملية تنفّذها بحيث تكون كذلك (خاصة عند تعديل قيمة ثابتة لا تراكمية).
الصياغة
PATCH /users/1 HTTP/1.1
Host: example.com
Content-Type: application/json
{"age": 31}📄 مثال
curl -X PATCH -H "Content-Type: application/json" -d '{"age":31}' https://api.example.com/users/1أهم النقاط
| العنصر | الوظيفة |
|---|---|
| تعديل جزئي | يُغيّر الحقول المذكورة في الطلب فقط |
| Idempotent عمليًّا غالبًا | المعيار لا يضمنها رسميًّا، لكن أغلب التطبيقات تلتزم بها |
💡 نصائح عملية
- استخدم PATCH لتحديث حقل أو حقلين، ووفّر جهد إرسال المورد كاملًا كما تتطلّب PUT
⚠️ أخطاء شائعة
- الخلط بين PATCH و PUT: PATCH للتحديث الجزئي، PUT للاستبدال الكامل
خصائص ذات صلة
🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار NETWORKING الكامل بالعربي.