POST https://app.alaaqat.com/api/products/{product_id}/notes
حيث product_id هو قيمة _id للمنتج. تضيف هذه النقطة ملاحظة إلى السجل، وتُكتب الملاحظة باسم عضو الفريق الذي أنشأ المفتاح. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية product-note-create، ويحتاج عضو الفريق الذي أنشأ المفتاح إلى صلاحية إضافة ملاحظة للمنتجات.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
{
description: string
}
| الحقل | مطلوب | التحققات | الوصف |
|---|---|---|---|
| description | مطلوب | نص | نص الملاحظة. |
{
"description": "سيرفع المورّد التكلفة بنسبة 5% اعتباراً من يناير، فراجِع السعر قبل بداية العام."
}
201 Created، وتأتي الملاحظة الجديدة ضمن data.
{
"data": {
"_id": "6658d1e2f3a4b5c6d7e8f901",
"description": "سيرفع المورّد التكلفة بنسبة 5% اعتباراً من يناير، فراجِع السعر قبل بداية العام.",
"product_id": "6656b1c2d3e4f5a6b7c8d901",
"made_by": 12,
"updated_at": "2026-10-20T09:30:00.000000Z",
"created_at": "2026-10-20T09:30:00.000000Z"
},
"message": "Entity was created successfully."
}
| الرمز | المعنى |
|---|---|
| 402 | وصل حسابك إلى حد الملاحظات في باقتك. راجع الباقات في صفحة الأسعار. |
| 422 | الحقل description غير موجود أو ليس نصاً. |