الطرق الأساسية
| الطريقة | الغرض | مثال |
|---|---|---|
GET | قراءة | جلب قائمة المستخدمين |
POST | إنشاء | إضافة مستخدم جديد |
PUT | استبدال كامل | تحديث مستخدم بالكامل |
PATCH | تعديل جزئي | تحديث حقل واحد |
DELETE | حذف | إزالة مستخدم |
أمثلة
GET /users → قائمة المستخدمين
GET /users/5 → المستخدم رقم 5
POST /users → إنشاء مستخدم (البيانات في الجسم)
PUT /users/5 → استبدال المستخدم 5
PATCH /users/5 → تعديل جزء من المستخدم 5
DELETE /users/5 → حذف المستخدم 5
خصائص مهمّة
- GET آمنة (Safe): لا تغيّر البيانات.
- GET و PUT و DELETE عديمة الأثر الجانبي (Idempotent): تكرارها يعطي نفس النتيجة.
- POST ليست idempotent: تكرارها ينشئ سجلّات متعدّدة.
💡 لا تستخدم GET لتعديل البيانات أبدًا — استخدم الطريقة المناسبة لكل عملية.
🎯 التالي: رموز الحالة.