DELETE
طريقة DELETE DELETE
تحذف المورد المحدَّد بالمسار.
DELETE idempotent: طلبها مرّتين على نفس المورد ينتهي بنفس الحالة (المورد محذوف)، حتى لو أعاد الطلب الثاني رمز حالة مختلفًا لأن المورد لم يعد موجودًا أصلًا. لا تحمل عادة جسم طلب.
الصياغة
DELETE /users/1 HTTP/1.1 Host: example.com
📄 مثال
curl -X DELETE https://api.example.com/users/1
أهم النقاط
| العنصر | الوظيفة |
|---|---|
| Idempotent | تكرارها ينتهي بنفس الحالة النهائية |
| بلا جسم طلب عادة | لا تحتاج body لتحديد ما تحذفه — المسار كافٍ |
💡 نصائح عملية
- أرجع رمز حالة واضح (200 أو 204) بعد الحذف الناجح ليعرف العميل أن العملية تمّت
⚠️ أخطاء شائعة
- استخدام GET لحذف بيانات بدل DELETE — يخالف مبدأ الأمان (Safety) ويسبّب حذفًا غير مقصود (مثلًا بواسطة زواحف البحث)
خصائص ذات صلة
🎓 تريد فهم الصورة الكاملة خطوة بخطوة؟ ابدأ من مسار NETWORKING الكامل بالعربي.