淘宝开放平台 - 文档中心

请求地址：

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

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

名称	类型	示例值	描述
ret_desc	String	成功	返回错误信息
station_list	ShipStation []		港口list
└ presell_time Number 120 班次发车前可售时间，单位分钟，不传默认设置为60 └ refund_msg String 1 退票提示(1:在线退票 2:不可在线退票 3:不可退票) └ from_station_name String 香港机场海天码头出发港口名称 └ latitude String 32.033114 维度 └ sell_end_time String 18:00 网上可售结束时间HH:mm(18:00)，不传默认无限制 └ is_order_refund Boolean 1 是否按照整个订单退款 └ sell_start_time String 05:00 网上可售开始时间HH:mm(06:00)，不传默认无限制 └ from_station_address String 香港机场海天码头港口地址 └ obtain_voucher String 凭订单号和身份证取票取票方式（0:凭身份证自助机取票 1:凭取票号取票，2:支持刷身份证乘车，3:-柜台取票,默认为0） └ max_sell_num Number 5 一单最大乘车人数, 不传默认无限制 └ city_name String 香港城市名称 └ refund_time Number 120 发车前允许退票时间 └ province String 香港省份名称 └ service_price String 100 服务费 └ is_refund Boolean 1 是否会允许退票 └ support_eticket Boolean true 是否支持电子票 └ from_station_code String 123456789 出发港口code └ presell_day Number 7 单位分钟，不传默认设置为60 └ longitude String 105.469673 经度 └ status Number 1 是否暂停售票，1:可售 0:不可售不传默认为1 └ station_tel String 0592)6209888 联系电话 └ open_time String 06:00 营业开始时间 └ close_time String 23:59 营业结束 └ support_child Boolean 1 是否支持儿童 └ support_with_child Boolean 1 是否支持携童 └ support_child_rule String xxx 支持儿童票规则 └ support_with_child_rule String xxx 支持携童票规则
ret_code	String	0	返回错误码
extAttr	String	{"param":"param"}	扩展属性 json格式
success	Boolean	true	状态

{"city_name":"香港","city_code":"810100"}

{
    "ret_desc":"成功",
    "station_list":[
        {
                "presell_time":120,
                "refund_msg":"1",
                "from_station_name":"香港机场海天码头",
                "latitude":"32.033114",
                "sell_end_time":"18:00",
                "is_order_refund":1,
                "sell_start_time":"05:00",
                "from_station_address":"香港机场海天码头",
                "obtain_voucher":"凭订单号和身份证取票",
                "max_sell_num":5,
                "city_name":"香港",
                "refund_time":120,
                "province":"香港",
                "service_price":"100",
                "is_refund":1,
                "support_eticket":true,
                "from_station_code":"123456789",
                "presell_day":7,
                "longitude":"105.469673",
                "status":1,
                "station_tel":"0592)6209888",
                "open_time":"06:00",
                "close_time":"23:59",
                "support_child":1,
                "support_with_child":1,
                "support_child_rule":"xxx",
                "support_with_child_rule":"xxx"
        }
    ],
    "ret_code":"0",
    "extAttr":"{\"param\":\"param\"}",
    "success":true
}

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

错误码	错误描述	解决方案

错误码查询工具 SDK下载

开放平台

船票API

qimen.alitrip.ship.product.querystation (查询出发港口接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ