淘宝开放平台

登录
文档中心 > API类目 > 商品API

商品API

qimen.taobao.life.booking.ticket.item.skus.query (本地生活预订门票商品库存价格查询)

1、合作方通知我方库存价格变更之后，我方会通过该接口查询最新库存价格信息 2、我方也会在一定时间主动查询该接口，同步最新的库存价格信息 3、我方主动发起会查询近90天的数据，若是通知则按照通知的时间查询

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
out_product_id String 可选 12321312 外部产品id
ticket_schedule String 可选 ALL_DAY 门票场次
start_date String 可选 2020-09-07 开始时间日期
end_date String 可选 2020-09-07 结束时间日期，必须大于等于开始时间日期，相等表示就查询这一天

响应参数

名称 类型 示例值 描述
price_inventory_list PriceInventory [] 库存价格列表
  • └ date
  • String
  • 2020-09-08
  • 日期
  • └ settlement_price
  • Number
  • 100
  • 结算价（单位：分）
  • └ mark_price
  • Number
  • 120
  • 门市价（单位：分）
  • └ stock
  • Number
  • 999
  • 当日库存
  • └ kb_price
  • Number
  • 100
  • 口碑价（单位：分）
biz_success Boolean true 业务是否成功
biz_error_code String SYSTEM_ERROR 错误代码，只有success=false需要是否成功
biz_error_message String 系统错误 错误信息，用来描述具体错误原因是否成功
success String true 是否成功（废弃，优先使用biz_开头的）
error_code String SYSTEM_ERROR 错误代码，只有success=false需要（废弃，优先使用biz_开头的）
error_message String 系统错误 错误信息，用来描述具体错误原因（废弃，优先使用biz_开头的）

请求示例

{"end_date":"2020-09-07","ticket_schedule":"ALL_DAY","out_product_id":"12321312","start_date":"2020-09-07"}

响应示例

{
    "price_inventory_list":[
        {
                "date":"2020-09-08",
                "settlement_price":100,
                "mark_price":120,
                "stock":999,
                "kb_price":100
        }
    ],
    "biz_success":true,
    "biz_error_code":"SYSTEM_ERROR",
    "biz_error_message":"系统错误",
    "success":"true",
    "error_code":"SYSTEM_ERROR",
    "error_message":"系统错误"
}

验签示例

{"error_message":"Illegal request","success":"false","error_code":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问
返回
顶部