qimen.alitrip.ship.product.queryroute (查询路线接口)

查询船票路线接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
from_city_name String 可选 北京 出发城市名称
from_city_code String 可选 C001 出发城市code

响应参数

名称 类型 示例值 描述
ret_desc String 成功 错误描述
route_list ShipRoute [] 路线列表
  • └ to_city_name
  • String
  • 深圳
  • 到达城市名称
  • └ from_station_name
  • String
  • 香港机场海天码头
  • 出发港口
  • └ line_name
  • String
  • 普通班次
  • 线路名称
  • └ to_station_code
  • String
  • 123456
  • 到达港口code
  • └ to_station_address
  • String
  • 蛇口港
  • 出发港口详细地址
  • └ to_province_name
  • String
  • 深圳
  • 到达属省份
  • └ to_station_longitude
  • String
  • 105.469673
  • 到达经度
  • └ to_station_name
  • String
  • 蛇口港
  • 到达港口名称
  • └ from_city_code
  • String
  • 001
  • 出发城市名称
  • └ lineDesc
  • String
  • xxx
  • 航线描述
  • └ to_station_latitude
  • String
  • 35.033114
  • 到达纬度
  • └ from_city_name
  • String
  • 香港
  • 出发城市名称
  • └ from_station_code
  • String
  • 123456789
  • 出发港口code
  • └ region_name
  • String
  • 珠三角
  • 区域名
  • └ to_city_code
  • String
  • 深圳
  • 到达城市编码
  • └ presell_time
  • Number
  • 120
  • 班次发车前可售时间,单位分钟
  • └ refund_msg
  • String
  • xx
  • 退票提示(1:在线退票 2:不可在线退票 3:不可退票)
  • └ 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),不传默认无限制
  • └ obtain_voucher
  • String
  • 凭订单号和身份证取票
  • 取票方式(0:凭身份证自助机取票 1:凭取票号取票,2:支持刷身份证乘车,3:-柜台取票,默认为0)
  • └ max_sell_num
  • Number
  • 5
  • 一单最大乘车人数, 不传默认无限制
  • └ refund_time
  • Number
  • 120
  • 发车前允许退票时间(单位分钟)
  • └ service_price
  • String
  • 100
  • 服务费
  • └ is_refund
  • String
  • 1
  • 是否会允许退票
  • └ support_eticket
  • String
  • true
  • 是否支持电子票
  • └ presell_day
  • String
  • 7
  • 预售期,不传默认设置为60
ret_code String 0 错误码
extAttr String {"param":"param"} 扩展属性 json格式
success String true 成功状态

请求示例

1
{"from_city_name":"北京","from_city_code":"C001"}

响应示例

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
{
    "ret_desc":"成功",
    "route_list":[
        {
                "to_city_name":"深圳",
                "from_station_name":"香港机场海天码头",
                "line_name":"普通班次",
                "to_station_code":"123456",
                "to_station_address":"蛇口港",
                "to_province_name":"深圳",
                "to_station_longitude":"105.469673",
                "to_station_name":"蛇口港",
                "from_city_code":"001",
                "lineDesc":"xxx",
                "to_station_latitude":"35.033114",
                "from_city_name":"香港",
                "from_station_code":"123456789",
                "region_name":"珠三角",
                "to_city_code":"深圳",
                "presell_time":120,
                "refund_msg":"xx",
                "sell_end_time":"18:00",
                "is_order_refund":1,
                "sell_start_time":"05:00",
                "obtain_voucher":"凭订单号和身份证取票",
                "max_sell_num":5,
                "refund_time":120,
                "service_price":"100",
                "is_refund":"1",
                "support_eticket":"true",
                "presell_day":"7"
        }
    ],
    "ret_code":"0",
    "extAttr":"{\"param\":\"param\"}",
    "success":"true"
}

验签示例

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

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部