文档中心 > API类目 > 汽车票API

qimen.alitrip.custombus.product.number.query (定制巴士查询班次接口)

汽车票定制巴士-查询班次信息

公共参数

请求地址：

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

请求参数

名称	类型	是否必须	示例值	描述
fromCity	String	必须	北京市	出发城市
toCity	String	必须	天津市	到达城市
fromDate	String	必须	2022-05-19	出发日期

响应参数

名称	类型	示例值	描述
retCode	String	0	错误码(必填)
retDesc	String	成功	错误信息(必填)
success	Boolean	true	是否成功(必填)
lineSchedule	LineSchedule []		线路信息
line Line 路线信息(必填) └ id String 123 线路id(必填) └ name String 成都-巴中线路名称(必填) └ desc String 成都-巴中线路描述 └ bottomPrice Number 50 线路票价，根据不同上下车点，取最低的票价，最少为1元(必填) └ distance Number 60 路程长度，单位公里 └ fromTimeType String 1 发车时间类型，1固定时间点发车、2按航班进出港发车、3用户决定发车时间、4固定时间段发车(必填) └ checkTicketMethods String 1,2 检票方式，1-短信、2-身份证、3-电子票二维码、4-纸质票(必填,如果选择了3电子票二维码则出票时要返回电子票票号，用户可在订单详情看到电子票码) └ timeExpendMinutes Number 60 路程耗时，单位分钟(必填) segmentPrices SegmentPrices [] 分站点价格(必填) └ fromStationCode String s1 上车站点唯一标识(必填) └ toStationCode String s2 下车站点唯一标识(必填) └ price Number 20 价格(必填) stations Stations [] 途经站信息(必填) └ id String s1 车站id，车站唯一标识与上述segmentPrices里的stationCode保持一致(必填) └ sequence Number 1 标识站点顺序，值越小离出发站越近(必填) └ address String 成都北站站点地址(必填) └ cityName String 成都市所属城市(必填) └ province String 四川省所属省份(必填) └ offsetMinutes Number 0 距离始发点耗时单位分钟。出发站为0，终点站应和timeExpendMinutes相同。(必填) └ waitMinutes Number 0 途径站等待耗时，单位分钟。出发站和终点站可以不填或填0。 └ boardingType String 1 1-上车2-下车点(必填) └ stationType Number 1 站点类型，1-单点，2-多边形（三角形、方形、长方形、多边形）电子围栏，3-圆形电子围栏(必填) └ latitude String 98.462351 站点纬度。(站点类型为1时必填) └ longitude String 30.404097 站点经度。(站点类型为1时必填) └ name String 成都市政府站点名称，如果提供接送服务，名称需要与ctrip约定并确定接送范围。(必填) └ stationFeature String 景区汽车站、火车站、地铁站、景区、酒店、街道、机场、港口、餐厅、购物商场、候机楼、停车场、医院、学校、商圈（目前如果传景区或者机场，用户在搜索的时候会有单独的tab呈现，没有合适的属性则可以不填，不填默认给用户展示站点） └ maxTicketNum Number 5 最大乘车人数 └ geofenceRadius String 200 圆形电子围栏圆心半径，站点类型为3圆形电子围栏时必填，单位米，整数，取值范[1,50000] geofence Coordinate [] 98.041513\|31.267343, 97.972523\|31.217944,98.462351\|30.404097, 98.103604\|31.25944 站点类型为2多边形电子围栏时必填，多个逗号分隔，最少三个经纬度，面积小于100平方公里 └ latitude String 30.404097 站点纬度(必填) └ longitude String 98.462351 站点经度(必填) geofenceCenter Coordinate 98.041513\|31.26734 圆形电子围栏圆心经纬度，站点类型为3圆形电子围栏时必填(暂不支持此类型站点) └ latitude String 30.404097 站点纬度 └ longitude String 98.462351 站点经度 geofences GraphGeofence [] 复杂电子围栏，与geofence\|geofenceCenter\|geofenceRadius互斥 └ type Number 1 图形类型1.单一点2.圆形3.多边形(必填) geofence Coordinate [] 必填，图形类型为1，2时只有一个点，3时最少三个点 └ latitude String 30.404097 站点纬度(必填) └ longitude String 98.462351 站点纬度(必填) └ radius String 30\|30.1 图形半径，单位米，保留两位小数 └ canSelect Boolean true 是否可选，覆盖区域会被置为禁止售卖，可以叠加在可售卖区域，被叠加的可售卖区域部分会置为不可售卖。(必填) └ price String 5.02\|-5.02 区域加价，（正负）最多支持两位小数 └ desc String xx城市xx街道接送图形描述 └ offsetTime String -10\|10 接送时间偏移,分钟 └ enableStartTime String 2023-11-03 11:56\|18:56 图形生效开始时间，只传日期则每天的该日期设置，永久生效忽略 └ enableEndTime String 2023-11-06 18:56\|18:56 图形生效结束时间，只传日期则每天的该日期设置，永久生效忽略 backLine BackLine 往返信息 └ backDays String 0 返程日期，0表示当天返回，1表示过1天（明天）返回，依次类推，最多支持过3天（大后天）返回。(必填) └ fromTime String 09:00 返程发车时间(必填) └ fromStationName String 成都汽车站返程出发站名称(必填) └ fromStationLongitude String 98.462351 返程出发站经度，高德地图经度(必填) └ fromStationAddress String 成都市xx街道xx号返程出发站地址(必填) └ fromStationLatitude String 30.404097 返程出发站纬度，高德地图纬度(必填) └ toStationName String 成都动物园返程到达站名称(必填) └ toStationAddress String 成都市xx街道xx号返程到达站地址(必填) └ toStationLongitude String 98.462351 返程到达站经度，高德地图经度(必填) └ toStationLatitude String 30.404097 返程到达站纬度，高德地图纬度(必填) └ desc String 班次与次日09:00返程往返说明(必填) specialTickets SpecialTickets [] 特殊票种 └ type String child 特殊票种code(必填) └ name String 儿童票特殊票名称(必填) └ discountPercent Number 50 折扣百分比，实际价=discountPercent*普通票价/100(必填) └ desc String 儿童身高在175以下特殊票详细描述，如描述适用条件等(必填) obtainTicket ObtainTicket 取票信息，如果需要乘客取纸质票的话必须填写。 └ address String 成都市政府门口取票地址(必填) └ latitude String 98.462351 取票地址纬度(必填) └ longitude String 30.404097 取票地址经度(必填) └ obtainVoucher String 1,2 取票凭证枚举:1:身份证，2:短信(如果此字段填写了则认为是需要取票，那么检票方式字段必须包含纸质票)(必填) └ invoice Boolean true 是否可以作为发票凭证(必填) refundTicketRule RefundTicketRule 退票规则(必填) └ isRefund Boolean true 是否支持退票(必填) └ desc String 发车时前120分钟退款手续费5% 退票规则描述 segmentRates SegmentRate [] 退票规则区间百分比(必填) └ begin String 120 距离发车时间段结束，闭区间，单位/分钟，为空表示0 └ end String 240 距离发车时间段结束，开区间，单位/分钟，为空代表无限大 └ percent String 10 手续费百分比(必填) └ isOrderRefund Boolean true 是否是按订单退票，true：按订单退，false：退票退 parkingPoints ParkingPoints [] 游玩点 └ offsetMinutes Number 30 距离始发点耗时，单位分钟。(必填) └ parkingMinutes Number 10 游玩时间(必填) └ name String 成都大熊猫基地游玩点名称(必填) └ desc String 成都大熊猫基地游玩点详细说明(必填) scenicTicket ScenicTicket 景点门票，票价中包含门票 └ scenicName String 成都大熊猫基地景点名称(必填) └ ticketDesc String 成都大熊猫基地门票+往返车票门票描述(必填) transferPoints TransferPoints [] 换车点信息 └ name String 成都第一中学换车点名称(必填) └ desc String 换大巴车换车说明，如换什么样的车等(必填) └ transferTime String 09:00 换车点时间(必填) └ address String 成都市xx街道xx号换车点地址(必填) └ transferStationLongitude String 98.462351 换车点经度，高德地图经纬度 └ transferStationLatitude String 30.404097 换车点纬度，高德地图经纬度 gift Gift 礼品信息 └ name String 上车礼礼物名称(必填) └ desc String 上车就送礼物描述(必填) hotel Hotel 酒店信息 └ roomNights String 2 间夜数(必填) └ name String 希尔顿酒店酒店名称(必填) └ type String 亲子房房型 luggageLimit LuggageLimit 行李限制 └ quantity Number 2 限制行李数量(必填) └ length Number 20 每个行李规格长度限制，单位cm(必填) └ width Number 10 每个行李规格宽度限制，单位cm(必填) └ height Number 90 每个行李规格高度限制，单位cm(必填) schedule Schedule [] 时刻表 └ scheduleId String X00001 排班id,所有班次必须保持唯一(必填) └ fromTime String 07:00 出发时间，发车时间类型为1时必填 └ fromDurationEnd String 06:00 出发时间止。发车时间类型为3、4时必填，为3时限制用户选择范围，为4时描述固定时间段的结束。 └ fromDurationBegin String 18:00 出发时间起。发车时间类型为3、4时必填，为3时限制用户选择范围，为4时描述固定时间段的开始。 └ leftTicketCnt Number 10 余票数(必填) └ seatCnt Number 6 座位数(必填) └ busLicense String 苏A33333 车牌号 └ advanceBookMinutes Number 60 此班次需要最少提前多少时间预定，单位分钟。如果需要超过发车时间后依然可售卖，这里需要传负数，并告知业务有此类需求。(必填) └ vehicleDesc String GL8别克商务车型描述，如：GL8别克商务 └ driverMobile String 15821210090 司机联系方式。 └ driverName String 李四司机姓名。 └ travelMeal String 含早餐餐食描述。如：含早餐。 └ isFlow Boolean true 流水班标志，fromTimeType为4时才会生效，不传或者1则代表是非流水班，2为流水班 └ flowDesc String 流水班流水班描述，fromTimeType为4时才会生效 └ combinationKey String 10002 组合套餐key。同一组合套餐商品使用相同key。组合套餐包含但不限于往返、门票、酒店、上车礼等。无组合套餐售卖可为空 └ combinationMainProduct Boolean true 是否是组合套餐中主班次商品，combinationKey不为空时必填。一个组合套餐只能有一个主商品。 └ combinationProductName String 往返套票组合套餐中商品名称。combinationKey不为空时必填。例：往返票、含门票、游玩点套票、含酒店套票等。不宜过长。 └ combinationProductDesc String 往返套餐组合套餐中商品描述。combinationKey不为空时必填。

请求示例

{"fromDate":"2022-05-19","toCity":"天津市","fromCity":"北京市"}

响应示例

{
    "retCode":"0",
    "retDesc":"成功",
    "success":true,
    "lineSchedule":[
        {
                "line":{
                    "id":"123",
                    "name":"成都-巴中",
                    "desc":"成都-巴中",
                    "bottomPrice":50,
                    "distance":60,
                    "fromTimeType":"1",
                    "checkTicketMethods":"1,2",
                    "timeExpendMinutes":60,
                    "segmentPrices":[
                        {
                                "fromStationCode":"s1",
                                "toStationCode":"s2",
                                "price":20
                        }
                    ],
                    "stations":[
                        {
                                "id":"s1",
                                "sequence":1,
                                "address":"成都北站",
                                "cityName":"成都市",
                                "province":"四川省",
                                "offsetMinutes":0,
                                "waitMinutes":0,
                                "boardingType":"1",
                                "stationType":1,
                                "latitude":"98.462351",
                                "longitude":"30.404097",
                                "name":"成都市政府",
                                "stationFeature":"景区",
                                "maxTicketNum":5,
                                "geofenceRadius":"200",
                                "geofence":[
                                    {
                                            "latitude":"30.404097",
                                            "longitude":"98.462351"
                                    }
                                ],
                                "geofenceCenter":{
                                    "latitude":"30.404097",
                                    "longitude":"98.462351"
                                },
                                "geofences":[
                                    {
                                            "type":1,
                                            "geofence":[
                                                {
                                                        "latitude":"30.404097",
                                                        "longitude":"98.462351"
                                                }
                                            ],
                                            "radius":"30|30.1",
                                            "canSelect":true,
                                            "price":"5.02|-5.02",
                                            "desc":"xx城市xx街道接送",
                                            "offsetTime":"-10|10",
                                            "enableStartTime":"2023-11-03 11:56|18:56",
                                            "enableEndTime":"2023-11-06 18:56|18:56"
                                    }
                                ]
                        }
                    ],
                    "backLine":{
                        "backDays":"0",
                        "fromTime":"09:00",
                        "fromStationName":"成都汽车站",
                        "fromStationLongitude":"98.462351",
                        "fromStationAddress":"成都市xx街道xx号",
                        "fromStationLatitude":"30.404097",
                        "toStationName":"成都动物园",
                        "toStationAddress":"成都市xx街道xx号",
                        "toStationLongitude":"98.462351",
                        "toStationLatitude":"30.404097",
                        "desc":"班次与次日09:00返程"
                    },
                    "specialTickets":[
                        {
                                "type":"child",
                                "name":"儿童票",
                                "discountPercent":50,
                                "desc":"儿童身高在175以下"
                        }
                    ],
                    "obtainTicket":{
                        "address":"成都市政府门口",
                        "latitude":"98.462351",
                        "longitude":"30.404097",
                        "obtainVoucher":"1,2",
                        "invoice":true
                    },
                    "refundTicketRule":{
                        "isRefund":true,
                        "desc":"发车时前120分钟退款手续费5%",
                        "segmentRates":[
                            {
                                    "begin":"120",
                                    "end":"240",
                                    "percent":"10"
                            }
                        ],
                        "isOrderRefund":true
                    },
                    "parkingPoints":[
                        {
                                "offsetMinutes":30,
                                "parkingMinutes":10,
                                "name":"成都大熊猫基地",
                                "desc":"成都大熊猫基地"
                        }
                    ],
                    "scenicTicket":{
                        "scenicName":"成都大熊猫基地",
                        "ticketDesc":"成都大熊猫基地门票+往返车票"
                    },
                    "transferPoints":[
                        {
                                "name":"成都第一中学",
                                "desc":"换大巴车",
                                "transferTime":"09:00",
                                "address":"成都市xx街道xx号",
                                "transferStationLongitude":"98.462351",
                                "transferStationLatitude":"30.404097"
                        }
                    ],
                    "gift":{
                        "name":"上车礼",
                        "desc":"上车就送"
                    },
                    "hotel":{
                        "roomNights":"2",
                        "name":"希尔顿酒店",
                        "type":"亲子房"
                    },
                    "luggageLimit":{
                        "quantity":2,
                        "length":20,
                        "width":10,
                        "height":90
                    }
                },
                "schedule":[
                    {
                            "scheduleId":"X00001",
                            "fromTime":"07:00",
                            "fromDurationEnd":"06:00",
                            "fromDurationBegin":"18:00",
                            "leftTicketCnt":10,
                            "seatCnt":6,
                            "busLicense":"苏A33333",
                            "advanceBookMinutes":60,
                            "vehicleDesc":"GL8别克商务",
                            "driverMobile":"15821210090",
                            "driverName":"李四",
                            "travelMeal":"含早餐",
                            "isFlow":true,
                            "flowDesc":"流水班",
                            "combinationKey":"10002",
                            "combinationMainProduct":true,
                            "combinationProductName":"往返套票",
                            "combinationProductDesc":"往返套餐"
                    }
                ]
        }
    ]
}

验签示例

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

错误码解释

错误码	错误描述	解决方案
parameter-type-error
isp.http-read-timeout
isp.http-connection-refuse
isp.http-connection-timeout
response-body-parse-error
isp.http-closed
http-service-unknown-error
isp.http-request-send-error

API工具

错误码查询工具 SDK下载

FAQ

有用( 0 ) 我要提问

返回
顶部

开放平台

汽车票API

qimen.alitrip.custombus.product.number.query (定制巴士查询班次接口)

公共参数

请求参数

响应参数

请求示例

响应示例

验签示例

错误码解释

API工具

FAQ