كيف تُطابَق HTTP methods مع CRUD، وماذا يعني safe وidempotent؟

أمثلة

الـ PUT /users/42 يرسل التمثيل الكامل ويستبدله؛ أمّا PATCH /users/42 فيرسل الحقول المراد تغييرها فقط (مثل { "email": "[email protected]" }).

Safe مقابل idempotent

هاتان خاصيتان مختلفتان:

• Safe — الـ method لا يعدّل حالة الخادم (قراءة فقط). GET وHEAD وOPTIONS آمنة (safe).
• Idempotent — إجراء الطلب نفسه N مرات له الأثر نفسه لإجرائه مرة واحدة. GET وPUT وDELETE وHEAD idempotent.

لماذا يهم

يسأل المُقابِلون هذا ليروا إن كنت تفهم دلالات HTTP جيدًا بما يكفي لبناء واجهات موثوقة. التمييز بين safe/idempotent ليس أكاديميًّا: فهو يحكم مباشرةً ما يُسمَح للعملاء والـ proxies والـ CDNs بفعله. الـ methods الآمنة (safe) يمكن تخزينها في cache وجلبها مسبقًا بحرية؛ والـ methods الـ idempotent يمكن إعادة محاولتها تلقائيًّا بعد انقطاع شبكي دون خطر تكرار الآثار الجانبية — ولهذا يستطيع العميل بأمان إعادة محاولة PUT أو DELETE لكن عليه الحذر عند إعادة محاولة POST (قد يُنشئ طلبين). الخطأ الكلاسيكي هو استخدام GET لإحداث آثار جانبية (مثل GET /users/42/delete)، ما يكسر الـ caching ويدع الزواحف (crawlers) تعدّل البيانات عرَضًا. اختيار الـ method الصحيح — واحترام عقده في الـ safety والـ idempotency — هو ما يجعل الـ API متوقّعًا وآمنًا لبناء الأدوات حوله.