中文版
产品文档1688 APITaobao / Tmall API增值API
产品文档1688 APITaobao / Tmall API增值API
English
  1. Taobao / Tmall 订单管理
  • Taobao / Tmall 商品搜索
    • 上传图片
      POST
    • 图片搜索
      GET
    • 关键词搜索
      GET
    • 店铺搜索
      GET
    • 商品详情搜索
      GET
    • 榜单类型搜索
      GET
    • 榜单商品搜索
      GET
    • 商品运费查询
      POST
    • 图搜2
      GET
  • Taobao / Tmall 订单管理
    • 撞库接口
      GET
    • 预览商品
      POST
    • 创建订单
      POST
    • 取消订单
      POST
    • 查询订单
      POST
  • Taobao / Tmall 订单支付
    • 支付订单
      POST
  • Taobao / Tmall 消息说明
    • 订单消息
    • 订单消息-签名验证
  1. Taobao / Tmall 订单管理

预览商品

POST
/taobao/purchase/order/render
预览商品接口,通过该接口可获得准确的价格与中国段运费,调用预览商品接口前,请先调用撞库接口(itemId使用mpId,skuId使用mpSkuid)。

请求参数

Body 参数application/json
appKey
string 
必需
大吉平台appKey
appSecret
string 
必需
秘钥,仅调试使用,正式用sign签名
need_supplychain_service
boolean 
填写false
必需
receiver_address
object 
必需
收货人地址信息(填写中国仓库信息即可)
country
string 
一级地址 (国家)
必需
state
string 
必需
二级地址 (省、自治区、直辖市)
city
string 
三级地址 (市)
必需
district
string 
必需
四级地址 (县、区、县级市)
address
string 
详细地址
必需
zip
string 
邮编
必需
name
string 
姓名
必需
phone
string 
电话
必需
mobile_phone
string 
手机号
必需
warehouse_address
object 
中国仓库地址
可选
country
string 
一级地址 (国家)
必需
state
string 
必需
二级地址 (省、直辖市、自治区)
city
string 
三级地址 (市)
必需
district
string 
必需
四级地址 (县、区、县级市)
address
string 
详细地址
必需
zip
string 
邮编
必需
name
string 
姓名
必需
phone
string 
电话
必需
mobile_phone
string 
手机号
必需
render_item_List
string 
必需
预览商品列表,此处itemId与skuId信息,需调用撞库接口获得mpId与mpSkuid,itemId请填写mpId,skuId请填写mpSkuid。
示例
{
  "appKey": "",
  "appSecret": "",
  "need_supplychain_service": false,
  "receiver_address": {
    "country": "中国",
    "state": "上海市",
    "city": "上海市",
    "district": "张江区",
    "address": "中华大街888号",
    "zip": "000000",
    "name": "张三",
    "phone": "18888888888",
    "mobile_phone": "18888888888"
  },
  "warehouse_address": {
    "country": "中国",
    "state": "上海市",
    "city": "上海市",
    "district": "张江区",
    "address": "中华大街888号",
    "zip": "000000",
    "name": "张三",
    "phone": "18888888888",
    "mobile_phone": "18888888888"
  },
  "render_item_List": "[{\"itemId\":2048153758314474,\"quantity\":\"1\",\"skuId\":3357413213162}]"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://openapi.dajisaas.com/taobao/purchase/order/render' \
--header 'Content-Type: application/json' \
--data-raw '{
    "appKey": "",
    "appSecret": "",
    "need_supplychain_service": false,
    "receiver_address":
    {
        "country": "中国",
        "state": "上海市",
        "city": "上海市",
        "district": "张江区",
        "address": "中华大街888号",
        "zip": "000000",
        "name": "张三",
        "phone": "18888888888",
        "mobile_phone": "18888888888"
    },
    "warehouse_address":
    {
        "country": "中国",
        "state": "上海市",
        "city": "上海市",
        "district": "张江区",
        "address": "中华大街888号",
        "zip": "000000",
        "name": "张三",
        "phone": "18888888888",
        "mobile_phone": "18888888888"
    },
    "render_item_List": "[{\"itemId\":2048153758314474,\"quantity\":\"1\",\"skuId\":3357413213162}]"
}'

返回响应

🟢200成功
application/json
Body
code
integer 
返回码
必需
message
string 
消息
必需
data
object 
业务数据
必需
result
object 
返回结果
必需
code
string 
返回码
必需
requestId
string 
必需
TraceId
string 
必需
timestamp
integer 
必需
traceId
string 
必需
示例
{
  "code": 200,
  "message": "操作成功",
  "data": {
    "result": {
      "data": {
        "totalRealPayPrice": {
          "amount": 1260,
          "currency": "CNY"
        },
        "unavailableSkuList": [],
        "renderItemList": [
          {
            "nick": "zhulinws286",
            "itemPriceInfos": [
              {
                "itemId": 2048153758314474,
                "quantity": 1,
                "discountPrice": {
                  "amount": 2180,
                  "currency": "CNY"
                },
                "originPrice": {
                  "amount": 2180,
                  "currency": "CNY"
                },
                "skuId": 3357413213162
              }
            ],
            "sellerId": 172619986,
            "mainlandShippingFee": {
              "amount": 0,
              "currency": "CNY"
            },
            "orderFee": {
              "amount": 1480,
              "currency": "CNY"
            },
            "chooseSupplyChainServices": []
          }
        ]
      },
      "success": true
    },
    "code": "0",
    "requestId": "2140d27417231084644394341",
    "TraceId": "2140cb3417231084644362884e5c80"
  },
  "timestamp": 1723108465539,
  "traceId": "c3602774b923"
}
上一页
撞库接口
下一页
创建订单
Built with