تعديل منتج

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 قيمة لا تطابق نوع خاصيتها، أو أُرسل حقل يضعه نظام علاقات بنفسه، أو قيمة مفتاح فريد مستخدمة مسبقاً.