상품 상세 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 권장
id하나 필요검색 id와 동일. Taobao = mi_id; 1688 = offerId
url하나 필요상품 페이지 URL
mi_idTaobaoTaoWorld 상품 id(주문에 권장)
tao_passwordTaobaoTaobao share口令 — 전체 공유 텍스트 또는 口令 문자열을 붙여 넣기
language아니요기본값 en
response_format아니요standard(기본값) 또는 upstream

Taobao id / mi_id는 주기적으로 바뀝니다. 장기 캐시하지 마세요. 만료된 id는 detail / similar / 주문에 실패합니다. 결제 전에 다시 조회하세요.

예시

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을 참고하세요. 옵션 매칭 시 Taobao는 prop_id + value_id, 1688는 prop_id를 우선하세요.

Get Support

Need integration help? Contact Developer Support at support@hiobuy.com · Response within 1–2 business days

Email support