Bir Ürünü Düzenle#

Bir ürünü senkron olarak günceller. Ürünü shopId ile birlikte productId veya sku kullanarak tanımlayın. Tam olarak bir tanımlayıcı sağlayın; her ikisini içeren veya hiçbirini içermeyen istekler 400 Bad Request döndürür.

http

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

Tanımlayıcı, product nesnesinden ayrı olarak belirtilir. Böylece entegrasyon, bir ürünü mevcut SKU değerine göre bulabilir ve aynı istekte SKU değerini değiştirebilir.

SKU değiştirirken tanımlayıcı olarak productId kullanın. Böylece ilk istek SKU değerini günceller ancak yanıt kaybolursa, yeniden denemelerde hangi ürünün hedeflendiği belirsiz olmaz.

Talep Gövdesi#

Alan	Tür	Gerekli	Açıklama
`shopId`	string	Evet	Ideal House tarafından sağlanan Shop ID.
`productId`	string	Koşullu	Bulunacak ürünün kimliği. `sku` belirtilmediğinde zorunludur.
`sku`	string	Koşullu	Bulunacak ürünün mevcut SKU değeri. `productId` belirtilmediğinde zorunludur.
`product`	object	Evet	Güncellenecek alanlar. En az bir alan ekleyin.

Düzenlenebilir Ürün Alanları#

Yalnızca product içinde belirtilen alanlar güncellenir.

Alan	Tür	Maksimum uzunluk	Açıklama
`sku`	string	120	Yeni SKU. Mağaza içinde benzersiz kalmalıdır.
`externalProductId`	string	120	Harici ürün tanımlayıcı.
`groupId`	string	120	Ürün grubu tanımlayıcısı.
`collectionId`	string	120	Ürün koleksiyonu tanımlayıcısı.
`name`	string	255	Ürün adı.
`title`	string	255	Ürünün gösterimde kullanılan başlığı.
`brand`	string	120	Ürün markası.
`productType`	string	120	Taksonominizdeki ürün türü.
`normalizedProductType`	string	40	Normalleştirilmiş ürün türü. Desteklenen değerleri Ideal House ile koordine edin.
`category`	string	120	Ürün kategorisi.
`style`	string	120	Ürün stili.
`color`	string	120	Ürün rengi.
`availability`	string	40	Ürün kullanılabilirliği değeri.
`imageUrl`	string	1,000	Herkese açık kaynak görselin HTTP veya HTTPS URL adresi.
`previewImageUrl`	string	1,000	HTTP veya HTTPS önizleme resmi URL'si.
`productUrl`	string	1,000	HTTP veya HTTPS ürün ayrıntısı URL'si.
`attributes`	object	—	Ürün özellikleri. Bu nesne sağlandığında geçerli öznitelikler nesnesinin yerini alır.
`status`	string	—	Ürün durumu. Güncelleme uç noktası `active` veya `inactive` değerini kabul eder.

Şu alanlar salt okunurdur: id, shopId, productCode, createdAt ve updatedAt. Bir ürünün durumunu invalid yapmak için silme uç noktasını kullanın.

SKU'ya göre düzenle#

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"
    }
  }'

Ürün Kimliğine Göre Düzenleme ve SKU'yu Değiştirme#

json

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

Başarılı bir güncelleme, 200 OK ve güncellenmiş ürün nesnesinin tamamını döndürür. inactive durumundaki ürün korunur ve ürün listeleme uç noktası üzerinden erişilebilir olmaya devam eder.