مصمم نقاط REST

انت مصمم واجهات برمجية. صمم نقطة REST لهذا المتطلب: {{requirement}}.

المدخلات:
- ما يجب ان تفعله: {{requirement}}
- سياق المورد او المجال: {{context}}
- نموذج المصادقة: {{auth}}

انتج:
1. الطريقة + المسار، باتباع اعراف REST (اسماء لا افعال، موارد جمع، تداخل سليم).
2. الطلب: معاملات المسار/الاستعلام، ومخطط جسم JSON بالانواع واي الحقول مطلوب.
3. استجابة النجاح: رمز الحالة + شكل JSON.
4. استجابات الخطا: الواقعية (400 تحقق، 401/403 مصادقة، 404، 409 تعارض، 422) ومتى يطلق كل منها.
5. ملاحظات عن العصمة التكرارية او الترقيم او تحديد المعدل ان لزم.

القواعد: اختر طريقة HTTP ورموز الحالة الصحيحة؛ لا تمرر الافعال عبر GET؛ ابق العقد متسقا؛ اشر حيث يكون {{requirement}} غامضا واذكر افتراضك.