ماذا يعني
نجح الطلب وأنشأ موردًا جديدًا. وعادةً تشير ترويسة Location إليه.
الأسباب الشائعة
- طلب POST إلى مجموعة أنشأ سجلًا
- طلب PUT أنشأ موردًا في عنوان جديد
طريقة الإصلاح
إن كنت العميل أو الزائر
اقرأ ترويسة Location لمعرفة عنوان المورد الجديد، أو استخدم الجسم المُعاد إذا كانت الواجهة تضمّن الكائن المُنشأ.
إن كنت مسؤولًا عن الموقع أو الواجهة البرمجية
ضمّن Location بالعنوان الجديد، ويُفضل تضمين التمثيل المُنشأ. لا تُعد 201 إن لم يُنشأ شيء؛ ويمكن لإعادات المحاولة المتساوية القوة (idempotent) التي تجد عنصرًا موجودًا أن تعيد 200 أو 409.
مثال على الاستجابة
HTTP/1.1
HTTP/1.1 201 Created
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Location: /users/42
Content-Type: application/json
{
"id": 42,
"name": "Ada"
}المواصفة
الأسئلة الشائعة
› هل ترويسة Location إلزامية مع 201؟
يوصى بها بشدة. فبدونها يضطر العملاء إلى تخمين العنوان الجديد من الجسم.
› ما الفرق بين 201 و202؟
201 تعني أن المورد موجود الآن بالفعل. 202 تعني أن الطلب قُبل وسيُعالج لاحقًا.