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