تحرير منتج#

يحدّث منتجًا واحدًا بصورة متزامنة. حدّد المنتج باستخدام productId أو sku، مع shopId. قدّم معرّفًا واحدًا فقط؛ فالطلبات التي تحتوي على كليهما أو لا تحتوي على أيٍّ منهما تعيد 400 Bad Request.

http

PATCH https://sdkapi.ideal.house/product-import/products

المعرّف منفصل عن الكائن product. يتيح ذلك للتكامل العثور على المنتج باستخدام SKU الحالي وتغيير SKU في الطلب نفسه.

استخدم productId كمعرف عند تغيير SKU. يؤدي هذا إلى إبقاء عمليات إعادة المحاولة واضحة إذا قام الطلب الأول بتحديث SKU ولكن تم فقدان الاستجابة.

جسم الطلب#

الميدان	النوع	مطلوب	الوصف
`shopId`	string	نعم	معرف المتجر مقدم من Ideal House. (Shop ID)
`productId`	string	مشروط	معرّف المنتج المطلوب العثور عليه. مطلوب إذا لم يُرسَل `sku`.
`sku`	string	مشروط	SKU الحالي المطلوب العثور عليه. مطلوب إذا لم يُرسَل `productId`.
`product`	object	نعم	الحقول المراد تحديثها. قم بتضمين حقل واحد على الأقل.

حقول المنتج القابلة للتحرير#

الحقول المدرجة فقط في product يتم تحديثها.

الميدان	النوع	الحد الأقصى للطول	الوصف
`sku`	string	120	رمز التخزين التعريفي الجديد. يجب أن تظل فريدة داخل المتجر. (SKU)
`externalProductId`	string	120	معرف المنتج الخارجي
`groupId`	string	120	معرف مجموعة المنتجات.
`collectionId`	string	120	معرف مجموعة المنتجات
`name`	string	255	اسم المنتج.
`title`	string	255	عنوان عرض المنتج.
`brand`	string	120	العلامة التجارية للمنتج.
`productType`	string	120	نوع المنتج في التصنيف الخاص بك.
`normalizedProductType`	string	40	نوع المنتج الموحّد. نسّق القيم المدعومة مع Ideal House.
`category`	string	120	فئة المنتج.
`style`	string	120	نمط المنتج.
`color`	string	120	لون المنتج.
`availability`	string	40	قيمة توفر المنتج
`imageUrl`	string	1,000	عنوان URL العام لصورة مصدر HTTP أو HTTPS.
`previewImageUrl`	string	1,000	عنوان URL لصورة معاينة HTTP أو HTTPS.
`productUrl`	string	1,000	عنوان URL لتفاصيل منتج HTTP أو HTTPS.
`attributes`	object	—	سمات المنتج. عند توفيره، يحل هذا الكائن محل كائن السمات الحالي.
`status`	string	—	حالة المنتج. تقبل نقطة نهاية التحرير `active` أو `inactive`.

الحقول التالية للقراءة فقط: id, shopId, productCode, createdAt، و updatedAt. استخدم نقطة نهاية الحذف لتعيين منتج عليها invalid.

تحرير بواسطة SKU#

json

{
  "shopId": "shop_123",
  "sku": "SKU-10001",
  "product": {
    "name": "Large Gold Wall Mirror",
    "color": "Antique Gold",
    "status": "active"
  }
}

bash

curl --request PATCH \
  'https://sdkapi.ideal.house/product-import/products' \
  --header 'Content-Type: application/json' \
  --header 'X-Client-Id: <YOUR_CLIENT_ID>' \
  --header 'X-Client-Secret: <YOUR_CLIENT_SECRET>' \
  --data-raw '{
    "shopId": "shop_123",
    "sku": "SKU-10001",
    "product": {
      "name": "Large Gold Wall Mirror",
      "color": "Antique Gold",
      "status": "active"
    }
  }'

قم بالتحرير حسب معرف المنتج وقم بتغيير SKU#

json

{
  "shopId": "shop_123",
  "productId": "product_123",
  "product": {
    "sku": "SKU-10001-NEW",
    "name": "Large Gold Wall Mirror",
    "status": "inactive"
  }
}

يعيد التحديث الناجح 200 OK وكائن المنتج المحدّث كاملًا. يُحتفظ بالمنتج ذي الحالة inactive ويظل متاحًا عبر نقطة نهاية عرض المنتجات.