상품 수정#

상품 하나를 동기로 수정합니다. shopId와 함께 productId 또는 sku로 상품을 식별하세요. 식별자는 정확히 하나만 제공해야 합니다. 둘 다 있거나 둘 다 없는 요청은 400 Bad Request를 반환합니다.

http

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

식별자는 product 객체와 분리되어 있습니다. 따라서 현재 SKU로 상품을 찾고 동일한 요청에서 SKU를 변경할 수 있습니다.

SKU를 바꿀 때는 식별자로 productId를 사용하세요. 그러면 첫 요청이 SKU를 수정했지만 응답이 유실되어도 재시도 대상을 명확히 유지할 수 있습니다.

요청 본문#

필드	유형	필수 여부	설명
`shopId`	string	예	Ideal House에서 제공하는 Shop ID.
`productId`	string	조건부	찾을 상품 ID. `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	공개 HTTP 또는 HTTPS 원본 이미지 URL.
`previewImageUrl`	string	1,000	HTTP 또는 HTTPS 미리보기 이미지 URL.
`productUrl`	string	1,000	HTTP 또는 HTTPS 상품 상세 URL.
`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"
    }
  }'

상품 ID로 수정 및 SKU 변경#

json

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

수정에 성공하면 200 OK와 수정된 전체 상품 객체를 반환합니다. inactive 상품은 유지되며 상품 목록 조회 엔드포인트에서 계속 사용할 수 있습니다.