文档中心 > API类目 > 汽车票API

qimen.alitrip.bus.product.queryseat (查询余票)

汽车票查询余票

公共参数

请求地址：

环境	HTTP请求地址
正式环境	http://qimen.api.taobao.com/router/qm
测试环境	http://qimen.api.taobao.com/router/qmtest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
customerId	String	是	WMS颁发给用户的ID
sign_method	String	是	签名的摘要算法，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
fromCityName	String	可选	北京		出发城市名称
fromCityCode	String	可选	C001		出发城市编码
toStationName	String	必须	古北水镇		到达名称
departDate	String	可选	2018-08-08		出发日期
busNumberList	BusNumber []	必须		最大列表长度：999	班次信息
└ departTime String 必须 2018-08-08 08:00:00 发车时间 └ scheduleId String 必须 123456789 班次id └ goodsId String 必须 99988800 商品id └ busNumber String 可选 b001 航线班次号 └ specialTicketCode String 可选 student 特殊票种code

响应参数

名称	类型	示例值	描述
retCode	String	0	错误码
retDesc	String	成功	错误描述
busSeatList	BusSeat []		列表（必填）
└ busNumber String 1111 班次号 └ distance Number 380 历程(单位公里) └ remainSeats Number 30 余票数（是必填） └ startCityCode String 001 出发城市编号（code定位时必填） └ startCityName String 北京出发城市名称（name定位时必填） └ lastPlaceName String 石家庄到达名称（是必填） └ startTimestamp String 2014-12-02 16:23:23 发车时间（是必填） └ scheduleId String 22104DC8D66FE5B6C97F508154CD8F20 车次id（是必填） └ goodsId String 001 商品id（是必填） └ specialTicketCode String student 特殊票种code（选填） └ fullPrice Number 60 全价(单位分)（是必填） └ originPrice Number 原始价格促销字段选填(单位分) └ halfPrice Number 30 半票价(单位分) └ servicePrice Number 100 服务费(单位分) └ supportChild Boolean true 是否支持儿童票 └ supportWithChild Boolean true 是否支持携童票 └ withChildStock String 4 携童票库存
success	Boolean	true	业务是否成功

请求示例

{"toStationName":"古北水镇","fromCityCode":"C001","busNumberList":[{"departTime":"2018-08-08 08:00:00","goodsId":"99988800","specialTicketCode":"student","scheduleId":"123456789","busNumber":"b001"}],"fromCityName":"北京","departDate":"2018-08-08"}

响应示例

{
    "retCode":"0",
    "retDesc":"成功",
    "busSeatList":[
        {
                "busNumber":"1111",
                "distance":380,
                "remainSeats":30,
                "startCityCode":"001",
                "startCityName":"北京",
                "lastPlaceName":"石家庄",
                "startTimestamp":"2014-12-02 16:23:23",
                "scheduleId":"22104DC8D66FE5B6C97F508154CD8F20",
                "goodsId":"001",
                "specialTicketCode":"student",
                "fullPrice":60,
                "originPrice":原始价格,
                "halfPrice":30,
                "servicePrice":100,
                "supportChild":true,
                "supportWithChild":true,
                "withChildStock":"4"
        }
    ],
    "success":true
}

验签示例

{"retDesc":"Illegal request","success":"false","retCode":"sign-check-failure"}

错误码解释

错误码	错误描述	解决方案

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

汽车票API

qimen.alitrip.bus.product.queryseat (查询余票)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ