淘宝开放平台 - 文档中心

请求地址：

环境	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输入参数签名结果，签名算法介绍请点击这里。

名称	类型	是否必须	示例值	更多限制	描述
cityCode	String	可选	810100		城市编码
cityName	String	可选	香港		城市名称

名称	类型	示例值	描述
retCode	String	0	返回错误码
retDesc	String	成功	返回错误信息
stationList	BusStation []		上车点list（是必填）
└ stationCode String 123456789 上车点编码（code定位时必传） └ stationName String 香港机场上车点名称（name定位时必传） └ stationAddress String 香港机场南口上车点地址（是必填） └ longitude String 105.469673 经度（是必填） └ latitude String 32.033114 维度（是必填） └ cityName String 香港城市名称（是必填） └ provinceName String 香港省份名称（是必填） └ presellDay Number 7 预售期单位分钟，不传默认设置为60 └ presellTime Number 120 班次发车前可售时间，单位分钟，不传默认设置为60（非必填） └ maxSellNum Number 5 一单最大乘车人数, 不传默认无限制 └ sellStartTime String 05:00 网上可售开始时间HH:mm(06:00)，不传默认无限制 └ sellEndTime String 18:00 网上可售结束时间HH:mm(18:00)，不传默认无限制 └ refundTime Number 120 发车前允许退票时间 └ isRefund Boolean true 是否会允许退票（是必填） └ isOrderRefund Boolean true 是否按照整个订单退款（是必填） └ refundMsg String 1 退票提示(1:在线退票 2:不可在线退票 3:不可退票)（是必填） └ obtainVoucher String 0 取票方式（0:凭身份证自助机取票 1:凭取票号取票，2:支持刷身份证乘车，3:-柜台取票,默认为0） └ supportEticket Boolean true 是否支持电子票（是必填） └ status Number 1 是否暂停售票，1:可售 0:不可售不传默认为1 └ servicePrice String 100 服务费 └ attribute String {"param":"param"} 扩展属性 json格式 └ supportWithChild Boolean false 是否支持携童票 └ supportChild Boolean true 是否支持儿童票 └ refundStructuredInfo String "[{"key":"发车前4-6小时","seq":"1","value":"不收取退票手续费"},{"ext":"如有紧急情况请联系车站","key":"发车前2-4小时","seq":"2","value":"收取5%手续费"},{"key":"发车前1-2小时","seq":"3","value":"收取10%手续费"}]" 退票提示文案结构化展示文案，数据为json列表
success	Boolean	true	成功状态

{"cityName":"香港","cityCode":"810100"}

{
    "retCode":"0",
    "retDesc":"成功",
    "stationList":[
        {
                "stationCode":"123456789",
                "stationName":"香港机场",
                "stationAddress":"香港机场南口",
                "longitude":"105.469673",
                "latitude":"32.033114",
                "cityName":"香港",
                "provinceName":"香港",
                "presellDay":7,
                "presellTime":120,
                "maxSellNum":5,
                "sellStartTime":"05:00",
                "sellEndTime":"18:00",
                "refundTime":120,
                "isRefund":true,
                "isOrderRefund":true,
                "refundMsg":"1",
                "obtainVoucher":"0",
                "supportEticket":true,
                "status":1,
                "servicePrice":"100",
                "attribute":"{\"param\":\"param\"}",
                "supportWithChild":false,
                "supportChild":true,
                "refundStructuredInfo":"\"[{\"key\":\"发车前4-6小时\",\"seq\":\"1\",\"value\":\"不收取退票手续费\"},{\"ext\":\"如有紧急情况请联系车站\",\"key\":\"发车前2-4小时\",\"seq\":\"2\",\"value\":\"收取5%手续费\"},{\"key\":\"发车前1-2小时\",\"seq\":\"3\",\"value\":\"收取10%手续费\"}]\""
        }
    ],
    "success":true
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

汽车票API

qimen.alitrip.bus.product.querystation (查询上车点接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ