qimen.alitrip.ship.product.querynumber (查询班次接口)

查询班次

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
to_station_code String 可选 S001 到达港口编码
from_city_code String 可选 C001 出发城市编码
from_city_name String 可选 北京 出发城市名称
to_station_name String 可选 古北水镇 到达港口名称
depart_date String 可选 2018-08-80 出发日期

响应参数

名称 类型 示例值 描述
ret_desc String 成功 错误描述
ship_number_list ShipNumber [] 班次列表
  • └ presell_time
  • String
  • 120
  • 班次发车前可售时间
  • └ from_longitude
  • String
  • 105.469673
  • 出发地经度
  • └ distance
  • String
  • 380
  • 里程
  • └ refund_msg
  • String
  • 本产品可在线退票,退票手续费3元
  • 退票提示文案
  • └ from_station_name
  • String
  • 六里桥
  • 上车点名称
  • └ dest_longitude
  • String
  • 100.12456004
  • 目的地经度
  • └ to_station_code
  • String
  • 111
  • 下车点区域code
  • └ service_info
  • String
  • 服务说明,温馨提示
  • 服务须知
  • parking_points
  • ParkingPoints []
  • 游玩点
  • └ parkingMinutes
  • Number
  • 60
  • 游玩时间
  • └ name
  • String
  • 卧佛寺
  • 游玩点名称
  • └ desc
  • String
  • 植物园停车游玩一小时
  • 游玩点详细说明
  • └ is_order_refund
  • String
  • 1
  • 是否按照整个订单退款
  • └ dest_latitude
  • String
  • 25.12456004
  • 目的地维度
  • └ to_province_name
  • String
  • 北京市
  • 下车点所属省份
  • obtain_ticket
  • ObtainTicket
  • 取票信息
  • └ obtain_voucher
  • String
  • 凭预订短信验证码取票
  • 取票凭证描述
  • └ address
  • String
  • 四惠汽车站对面
  • 取票详细地址
  • └ latitude
  • String
  • 100.12456004
  • 取票地址纬度
  • └ invoice
  • Boolean
  • true
  • 是否可以作为发票凭证
  • └ longitude
  • String
  • 25.62456004
  • 取票地址经度
  • └ ticket_tel
  • String
  • 4000535411
  • 取票电话
  • └ arrive_time
  • String
  • 2018-11-30 11:30
  • 到达时间
  • └ refund_type
  • String
  • 1
  • 退票类型1:在线退票 2:不可在线退票 3:不可退票
  • └ fromLatitude
  • String
  • 32.433114
  • 出发地维度
  • └ last_schedule
  • String
  • 18:00
  • 最晚发车时间 mm:ss 流水班返回
  • └ from_city_name
  • String
  • 北京
  • 上车点城市名称
  • └ ship_type
  • String
  • 普通客船/大型高速客船/高级游轮等
  • 航线类型
  • └ schedule_id
  • String
  • A1K001_AP6A6A70_2366_201811301520
  • 班次id
  • └ stationId
  • String
  • A0001
  • stationId
  • └ to_city_name
  • String
  • 北京
  • 下车点归属城市
  • └ depart_time
  • String
  • 2018-11-30 05:00
  • 发车时间
  • └ shift_type
  • String
  • 1
  • 班次类型0:固定班 1:流水班2:加班班次
  • └ refund_time
  • String
  • 30
  • 发车前允许退票时间,分钟。发车前允许退票时间,分钟
  • number_goods
  • NumberGoods []
  • 商品goods
  • └ goods_id
  • String
  • 0001
  • 商品id(舱位类型)
  • └ stock
  • String
  • 38
  • 总库存
  • └ goods_name
  • String
  • 三等B
  • 商品名称
  • └ goods_desc
  • String
  • 8人间
  • 商品描述
  • └ goods_url
  • String
  • http
  • 商品图片
  • 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
  • 5
  • 支持最小年龄
  • └ support_age_max
  • Number
  • 10
  • 支持最大年龄
  • └ stock
  • Number
  • 10
  • 库存
  • └ origin_price
  • Number
  • 50
  • 原始价格
  • └ price_type_id
  • String
  • 0001
  • 价格类型id(支付标识)
  • └ total_seats
  • String
  • 55
  • 总座位数
  • └ ship_number
  • String
  • AP6A6A70
  • 航线班次号
  • └ product_info
  • String
  • 本产品可领取上车礼,可能根据预订人数升级车型
  • 产品信息
  • └ to_station_name
  • String
  • 古北水镇
  • 下车点名称
  • └ real_name_grade
  • String
  • 2|3
  • 实名校验规则
  • └ max_sell_num
  • String
  • 5
  • 一单最大乘车人数
  • schedulePoints
  • SchedulePoints []
  • 换乘信息,中途需要换乘的填写
  • └ from_station_name
  • String
  • 南浦大桥客运站
  • 出发站
  • └ to_station_name
  • String
  • 干斜码头
  • 到达站
  • └ dep_time
  • String
  • 10:35
  • 出发时间
  • └ to_time
  • String
  • 19:06
  • 到达时间
  • └ vehicle_type
  • String
  • 中型客车/大型高速客运/普通客运
  • 交通工具
  • └ cost_time
  • String
  • 1小时45分
  • 花费时间单位(分)
  • └ from_station_longitude
  • String
  • 1
  • 出发站经度
  • └ from_station_latitude
  • String
  • 1
  • 出发站维度
  • └ to_station_longitude
  • String
  • 1
  • 到达站经度
  • └ to_station_latitude
  • String
  • 1
  • 到达站经度
  • └ service_price
  • String
  • 100
  • 服务费
  • └ is_refund
  • String
  • 1
  • 是否会允许退票1:是 0:否(可空,为空时以查询车站接口出参中的isRefund字段为准)
  • └ support_eticket
  • String
  • true
  • 是否支持电子票true:表示支持,false:表示不支持
  • └ from_station_code
  • String
  • 006
  • 上车点编码
  • └ from_city_code
  • String
  • 110100
  • 上车点城市编号 选
  • └ ticket_wicket
  • String
  • 码头
  • 检票口
  • └ via_station
  • String
  • a,b,c
  • 途径站,逗号分隔
  • └ transfer_station
  • String
  • xxx,xxx
  • 中转(逗号分隔)
  • └ ship_url
  • String
  • http://
  • 船图片
  • └ ship_name
  • String
  • 中铁渤海2号
  • 船名
  • └ to_date
  • String
  • 2018-11-30
  • 到达日期
  • └ vendor
  • String
  • 中铁渤海铁路轮渡有限责任公司--2--RG
  • 供应商
  • └ region_name
  • String
  • 渤海海峡
  • 区域名称
  • └ ext_category_id
  • String
  • 0为普通班次, 1为车船联运, 2为机场线,3为携车上船
  • 路线类型
  • └ flow_schedule_interval
  • Number
  • 20
  • 流水班间隔(单位分钟)
  • └ route_type_desc
  • String
  • 车送码头...
  • 路线类型说明
  • └ route_type_tag
  • String
  • 无需中转 车送码头
  • 路线类型标签
  • └ ext_category_desc
  • String
  • 本航线仅用于飞机航班接驳,且您的飞行目的地(包括中转地)必须为境外城市。由香港出发或前往香港作入境停留的旅客、持航空公司职员或家属机票、需前往机场取行李或其他遗留物品或接送亲朋好友者、所选航班不在海天码头合作航空公司名单内的及其他情况不可购买!
  • 票种描述
  • └ ticket_voucher
  • String
  • 电子二维码
  • 检票凭证
ret_code String 0 错误码
extAttr String {"param":"param"} 扩展属性 json格式
success Boolean true 成功状态

请求示例

{"to_station_code":"S001","from_city_name":"北京","to_station_name":"古北水镇","from_city_code":"C001","depart_date":"2018-08-80"}

响应示例

{
    "ret_desc":"成功",
    "ship_number_list":[
        {
                "presell_time":"120",
                "from_longitude":"105.469673",
                "distance":"380",
                "refund_msg":"本产品可在线退票,退票手续费3元",
                "from_station_name":"六里桥",
                "dest_longitude":"100.12456004",
                "to_station_code":"111",
                "service_info":"服务说明,温馨提示",
                "parking_points":[
                    {
                            "parkingMinutes":60,
                            "name":"卧佛寺",
                            "desc":"植物园停车游玩一小时"
                    }
                ],
                "is_order_refund":"1",
                "dest_latitude":"25.12456004",
                "to_province_name":"北京市",
                "obtain_ticket":{
                    "obtain_voucher":"凭预订短信验证码取票",
                    "address":"四惠汽车站对面",
                    "latitude":"100.12456004",
                    "invoice":true,
                    "longitude":"25.62456004",
                    "ticket_tel":"4000535411"
                },
                "arrive_time":"2018-11-30 11:30",
                "refund_type":"1",
                "fromLatitude":"32.433114",
                "last_schedule":"18:00",
                "from_city_name":"北京",
                "ship_type":"普通客船\/大型高速客船\/高级游轮等",
                "schedule_id":"A1K001_AP6A6A70_2366_201811301520",
                "stationId":"A0001",
                "to_city_name":"北京",
                "depart_time":"2018-11-30 05:00",
                "shift_type":"1",
                "refund_time":"30",
                "number_goods":[
                    {
                            "goods_id":"0001",
                            "stock":"38",
                            "goods_name":"三等B",
                            "goods_desc":"8人间",
                            "goods_url":"http",
                            "price_types":[
                                {
                                        "price_type_rule":"儿童票身高1.1.2-1.5米(不含1.5米)之间的儿童可至港口购买儿童票,超过1.5米请购买全价票;14周岁以上请购成人票。",
                                        "price_type":3,
                                        "price":40,
                                        "support_age_min":5,
                                        "support_age_max":10,
                                        "stock":10,
                                        "origin_price":50,
                                        "price_type_id":"0001"
                                }
                            ]
                    }
                ],
                "total_seats":"55",
                "ship_number":"AP6A6A70",
                "product_info":"本产品可领取上车礼,可能根据预订人数升级车型",
                "to_station_name":"古北水镇",
                "real_name_grade":"2|3",
                "max_sell_num":"5",
                "schedulePoints":[
                    {
                            "from_station_name":"南浦大桥客运站",
                            "to_station_name":"干斜码头",
                            "dep_time":"10:35",
                            "to_time":"19:06",
                            "vehicle_type":"中型客车\/大型高速客运\/普通客运",
                            "cost_time":"1小时45分",
                            "from_station_longitude":"1",
                            "from_station_latitude":"1",
                            "to_station_longitude":"1",
                            "to_station_latitude":"1"
                    }
                ],
                "service_price":"100",
                "is_refund":"1",
                "support_eticket":"true",
                "from_station_code":"006",
                "from_city_code":"110100",
                "ticket_wicket":"码头",
                "via_station":"a,b,c",
                "transfer_station":"xxx,xxx",
                "ship_url":"http:\/\/",
                "ship_name":"中铁渤海2号",
                "to_date":"2018-11-30",
                "vendor":"中铁渤海铁路轮渡有限责任公司--2--RG",
                "region_name":"渤海海峡",
                "ext_category_id":"0为普通班次, 1为车船联运, 2为机场线,3为携车上船",
                "flow_schedule_interval":20,
                "route_type_desc":"车送码头...",
                "route_type_tag":"无需中转 车送码头",
                "ext_category_desc":"本航线仅用于飞机航班接驳,且您的飞行目的地(包括中转地)必须为境外城市。由香港出发或前往香港作入境停留的旅客、持航空公司职员或家属机票、需前往机场取行李或其他遗留物品或接送亲朋好友者、所选航班不在海天码头合作航空公司名单内的及其他情况不可购买!",
                "ticket_voucher":"电子二维码"
        }
    ],
    "ret_code":"0",
    "extAttr":"{\"param\":\"param\"}",
    "success":true
}

验签示例

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

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部