상품 상세 API

POST /v1/products/detail — 체크아웃 연동에 필요한 전체 상품 상세(SKU 매트릭스, 가격, 재고)를 가져옵니다.

관련 문서: Product response models · Procurement mapping

요청 본문

필드필수설명
channel예1688 | taobao | weidian
product_id하나 필요1688 offerId; Taobao는 legacy item_id보다 mi_id 권장
url하나 필요상품 페이지 URL
mi_idTaobaoTaoWorld 상품 id(주문에 권장)
tao_passwordTaobaoTaobao share口令 — 전체 공유 텍스트 또는 口令 문자열을 붙여 넣기
language아니요기본값 en
response_format아니요standard(기본값) 또는 upstream

예시

Taobao口令:

POST /v1/products/detail
{
  "channel": "taobao",
  "tao_password": "￥abc123￥ 复制这条信息...",
  "language": "en"
}

1688 offer id:

POST /v1/products/detail
{
  "channel": "1688",
  "product_id": "554456348334",
  "language": "en"
}

응답

StandardProductDetail이 { "product": { ... }, "request_id": "req_..." } 형태로 감싸져 반환됩니다 — Product response models 참고.

Variant 선택

product.variants[]에서 체크아웃 UI를 구성하세요 — integration pattern을 참고하세요.