淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
to_station_name	String	可选	古北水镇		到达港口名称
from_city_code	String	可选	C001		出发城市编码
ship_number_param_list	ShipNumber []	可选		最大列表长度：999	班次信息
└ depart_time String 可选 2018-08-80 08:00:00 发车时间 └ goods_id String 可选 99988800 商品id(舱位类型) └ schedule_id String 可选 123456789 班次id └ ship_number String 可选 b001 航线班次号
from_city_name	String	可选	北京		出发城市名称
depart_date	String	可选	2018-08-80		出发日期
extAttr	String	可选	{"param":"param"}		扩展属性

名称	类型	示例值	描述
ret_desc	String	成功	错误描述
ship_seat_list	ShipSeat []		列表
└ distance Number 380 历程(单位公里) └ depart_time String 2014-12-02 16:23:23 发车时间 └ goods_id String 001 商品id(舱位类型) └ number String 1111 班次号 └ to_station_name String 石家庄到达港口名称 └ from_city_code String 001 出发城市编号 └ service_price Number 100 服务费 └ from_city_name String 北京出发城市名称 └ run_time String 130 该班次车程的耗时 └ schedule_id String 22104DC8D66FE5B6C97F508154CD8F20 车次id └ to_station_code String 1111 到达港口编码 price_types PriceTypes [] 价格类型 └ price_type_rule String 1.1.2-1.5米（不含1.5米）之间的儿童可至港口购买儿童票，超过1.5米请购买全价票；14周岁以上请购成人票。格类型说明（多个用\|分隔） └ price_type Number 3 价格类型(0:全价票,1:儿童票,2:携童票,3:残疾人,4:军人,5:高龄老人,6:学生票) └ price Number 40 余票数 └ support_age_min Number 2 支持最小年龄 └ support_age_max Number 14 支持最大年龄 └ stock Number 10 库存 └ origin_price Number 40 原始价格 └ price_type_id String 10001 价格类型 └ stock Number 100 总库存数
ret_code	String	0	错误码
success	Boolean	true	成功状态

{"to_station_name":"古北水镇","from_city_name":"北京","ship_number_param_list":[{"depart_time":"2018-08-80 08:00:00","goods_id":"99988800","ship_number":"b001","schedule_id":"123456789"}],"from_city_code":"C001","depart_date":"2018-08-80","extAttr":"{\"param\":\"param\"}"}

{
    "ret_desc":"成功",
    "ship_seat_list":[
        {
                "distance":380,
                "depart_time":"2014-12-02 16:23:23",
                "goods_id":"001",
                "number":"1111",
                "to_station_name":"石家庄",
                "from_city_code":"001",
                "service_price":100,
                "from_city_name":"北京",
                "run_time":"130",
                "schedule_id":"22104DC8D66FE5B6C97F508154CD8F20",
                "to_station_code":"1111",
                "price_types":[
                    {
                            "price_type_rule":"1.1.2-1.5米（不含1.5米）之间的儿童可至港口购买儿童票，超过1.5米请购买全价票；14周岁以上请购成人票。",
                            "price_type":3,
                            "price":40,
                            "support_age_min":2,
                            "support_age_max":14,
                            "stock":10,
                            "origin_price":40,
                            "price_type_id":"10001"
                    }
                ],
                "stock":100
        }
    ],
    "ret_code":"0",
    "success":true
}

{"success":"false","ret_desc":"Illegal request","ret_code":"sign-check-failure"}

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

船票API

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

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ