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 غير موجود أو ليس نصاً. |