تعديل ملاحظة على منتج

PUT https://app.alaaqat.com/api/products/{product_id}/notes/{note_id}

حيث product_id هو قيمة _id للمنتج وnote_id هو قيمة _id للملاحظة. تستبدل هذه النقطة نص الملاحظة. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية product-note-update، ويحتاج عضو الفريق الذي أنشأ المفتاح إلى صلاحية تعديل ملاحظة للمنتجات.

ويظهر عضو الفريق ذاك بعدها كاتباً للملاحظة في made_by.

ترويسة الطلب

{
    "Accept": "application/json",
    "Content-Type": "application/json"
}

محتوى الطلب

الحقل مطلوب التحققات الوصف
description مطلوب نص النص الجديد للملاحظة.
{
    "description": "سيرفع المورّد التكلفة بنسبة 5% اعتباراً من يناير، فراجِع السعر قبل بداية العام. تم ذلك."
}

الإستجابة

200 OK، وتأتي الملاحظة بعد التعديل ضمن data.

{
    "data": {
        "_id": "6658d1e2f3a4b5c6d7e8f901",
        "description": "سيرفع المورّد التكلفة بنسبة 5% اعتباراً من يناير، فراجِع السعر قبل بداية العام. تم ذلك.",
        "product_id": "6656b1c2d3e4f5a6b7c8d901",
        "made_by": 12,
        "updated_at": "2026-10-21T08:40:12.000000Z",
        "created_at": "2026-10-20T09:30:00.000000Z"
    },
    "message": "Entity was modified successfully."
}

الأخطاء

الرمز المعنى
404 لا توجد على هذا السجل ملاحظة بقيمة _id هذه.
422 الحقل description غير موجود أو ليس نصاً.