주문 Preview API
POST /v1/orders/preview — 생성 전에 라인, 가격, 중국 내 운임을 검증합니다.
관련 문서: Create order · Response model
요청 본문
| 필드 | 필수 | 설명 |
|---|---|---|
channel | 예 | 1688 | taobao |
receiver | 예 | 중국 내 입고 주소: name, mobile, province, city, address; 1688에서 address_id가 없으면 district도 필요 |
lines[] | 예 | 각 라인의 offer_id, spec_id, quantity |
response_format | 아니요 | standard(기본값) 또는 upstream |
Taobao: Gateway가 mi_id + traffic sku_id를 자동으로 배치 확인한 뒤 upstream render를 호출합니다.
예시
POST /v1/orders/preview
{
"channel": "1688",
"receiver": {
"name": "张三",
"mobile": "15251667788",
"province": "浙江省",
"city": "杭州市",
"district": "滨江区",
"address": "网商路699号"
},
"lines": [
{
"offer_id": "554456348334",
"spec_id": "b266e0726506185beaf205cbae88530d",
"quantity": 5
}
]
}응답
StandardOrderPreviewResult — order response models를 참고하세요. JSON 예시: Response format.