PUT https://app.alaaqat.com/api/products/{product_id}
حيث product_id هو قيمة _id للمنتج. تغيّر هذه النقطة قيم الخصائص التي ترسلها، وتبقى الخصائص الأخرى كما هي. يحتاج مفتاح واجهة التطبيق البرمجية إلى الإمكانية product-update، ويحتاج عضو الفريق الذي أنشأ المفتاح إلى صلاحية تعديل المنتجات.
{
"Accept": "application/json",
"Content-Type": "application/json"
}
قيم الخصائص نفسها المذكورة في إنشاء منتج: كل مفتاح هو internal_name لخاصية، ويجب أن تطابق كل قيمة نوعها. أرسل الخصائص التي تريد تغييرها فقط، ولإفراغ قيمة أرسل null.
{
"price": 115,
"status": "unavailable"
}
إذا كانت إحدى الخصائص المرسلة مفتاحاً فريداً، فيجب ألا تكون قيمتها لسجل آخر من المنتجات. وإلا لا يُعدَّل شيء، ويُرفض الطلب بالرمز 422 مع خطأ على ذلك الحقل.
200 OK، ويأتي السجل كاملاً ضمن data.
{
"data": {
"properties": {
"_id": "6656b1c2d3e4f5a6b7c8d901",
"name": "Ergonomic office chair",
"sku": "CH-ERGO-01",
"price": 115,
"cost": 74.5,
"status": "unavailable",
"description": "Adjustable height and lumbar support, black mesh back.",
"owner": 12,
"created_by": 12,
"updated_at": "2026-10-21T08:40:12.000000Z",
"created_at": "2026-10-20T09:30:00.000000Z"
},
"account_id": 1024
},
"message": "Entity was modified successfully."
}
| الرمز | المعنى |
|---|---|
| 403 | عضو الفريق الذي أنشأ المفتاح لا يستطيع تعديل إلا المنتجات التي يملكها هو أو فرقه، وهذا السجل ليس منها. |
| 404 | لا يوجد في حسابك سجل بقيمة _id هذه. |
| 422 | قيمة لا تطابق نوع خاصيتها، أو أُرسل حقل يضعه نظام علاقات بنفسه، أو قيمة مفتاح فريد مستخدمة مسبقاً. |