شرح صفوف ومحتوى الفقرة
عند بناء أو فحص واجهات البرمجة القياسية ()، يمنحك التمييز بين كودي و دقة هندسية أعلى من الاكتفاء بكود العام:
- كود (تم الإنشاء): يُعاد عندما ينجح طلب (غالباً أو ) في إنشاء سجل أو مورد جديد فعلياً على الخادم. ومن أفضل الممارسات القياسية إرفاق حقل الرأس متضمناً رابط المورد الجديد مع إرجاع بياناته في الجسم.
- كود (ناجح بدون محتوى): يُعاد عند نجاح عملية (مثل حذف سجل بـ أو حفظ تلقائي للإعدادات) دون حاجة لإرجاع أي بيانات في الجسم؛ ويُحظر احتواء استجابة على أي بايتات في الجسم.
Shell
HTTP/1.1 201 Created
Location: https://api.closetag.com/v1/users/42
Content-Type: application/json; charset=utf-8
Content-Length: 33
{"id":42,"username":"ali_dev"}
HTTP/1.1 204 No Content
Date: Wed, 05 Nov 2026 12:25:00 GMTمرجع بقية أكواد النجاح التخصصية في الفئة :
- كود (تم القبول للمعالجة): يُفيد باستلام الطلب ووضعه في طابور المعالجة غير المتزامنة بالخلفية (مثل تصدير تقرير ضخم أو معالجة فيديو) دون اكتمال النتيجة لحظياً.
- كود (معلومات معدلة لدى وسيط): يرسله خادم وسيط قام بتعديل بعض حقول الرأس أو التمثيل القادم من الخادم الأصلي.
- كود (إعادة تعيين المحتوى): يطلب من المتصفح تفريغ حقول النموذج () بعد نجاح الإرسال لتمكين إدخال سجل جديد، ولا يتضمن جسم رسالة.
- كود (المحتوى الجزئي): يُستخدم عند طلب جزء محدد من ملف كبير عبر حقل الرأس (مثل تقديم الفيديو أو استكمال تنزيل متوقف)، ويُرفق بحقل .
- الأكواد و و: أكواد متخصصة تُستخدم في عمليات المجمعة (إرجاع حالة عدة ملفات في رد واحد) وتطبيقات الفروق الجزئية.