alitrip.btrip.supplychain.bus.industry.search (汽车票行业搜索接口)

汽车票行业搜索接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
rq BusSearchRq 可选 入参
  • └ arr_city
  • String
  • 可选
  • 临湘
  • 到达城市
  • └ arrive_city_name
  • String
  • 可选
  • 临湘,房县
  • 目的地名称过虑条件。多个用都还分隔,如:临湘,房县,枣阳
  • └ dep_city
  • String
  • 可选
  • 临湘
  • 出发城市
  • └ dep_date
  • String
  • 可选
  • 2021-05-19
  • 出发日期
  • └ from_station_name
  • String
  • 可选
  • 天河客运站,越秀南客运站
  • 出发车次名称过虑条件,多个用逗号分隔,如:省汽车客运站,天河客运站,越秀南客运站
  • └ period_time
  • String
  • 可选
  • 1,2
  • 针对发车时段过滤新增字段:1:凌晨 2:上午 3:下午 4:晚上,多个用逗号分隔
  • └ scene
  • String
  • 可选
  • common
  • 汽车票场景 普通 common 机场巴士 airport
  • └ show_no_sell
  • Number
  • 可选
  • 0
  • 是否显示不可售车次
  • └ standard_from_area_code
  • String
  • 可选
  • 123
  • 标准出发城市编码
  • └ standard_from_station_id
  • Number
  • 可选
  • 123
  • 标准出发站编码
  • └ standard_from_station_name
  • String
  • 可选
  • 天河客运站
  • 出发车站名称
  • └ standard_to_area_code
  • String
  • 可选
  • 123
  • 标准到达城市编码
  • └ to_station_name
  • String
  • 可选
  • 省汽车客运站,天河客运站,越秀南客运站
  • 针对到达站过滤新增字段,多个用逗号分隔
  • └ corp_id
  • String
  • 必须
  • 123
  • 第三方企业ID
  • └ page_index
  • Number
  • 可选
  • 1
  • 当前页
  • └ page_size
  • Number
  • 可选
  • 50
  • 每页大小

响应参数

名称 类型 示例值 描述
result HisvResult module 出参
  • module
  • BusSearchRs
  • module
  • 汽车搜索查询结果
  • └ arr_city
  • String
  • 临湘
  • 到达城市
  • bus_lines
  • BusLineInfoVo []
  • []
  • 查询结果
  • └ arr_station
  • String
  • 天河客运站
  • 到达站
  • └ arrival_time
  • String
  • 2021-05-19 00:00:00
  • 到达时间(yyyy-MM-dd HH:mm:ss)
  • └ bus_distance
  • String
  • 100
  • 距离
  • └ bus_no_id
  • Number
  • 111
  • 车次id
  • └ bus_number
  • String
  • 11
  • 客车车次
  • └ bus_number_uuid
  • Number
  • 123
  • 车次全局唯一id
  • └ bus_type
  • String
  • 123
  • 车型id
  • └ dep_city
  • String
  • 临湘
  • 出发城市
  • └ dep_station
  • String
  • 省汽车客运站
  • 出发站
  • └ depart_time
  • String
  • 2021-05-19 00:00:00
  • 出发时间
  • └ extra_schedule
  • Boolean
  • false
  • 是否加班车
  • └ full_price
  • Number
  • 100
  • 全价票价(单位:分)
  • └ half_price
  • Number
  • 100
  • 半票票价(单位:分)
  • └ is_support_e_ticket
  • Number
  • 0
  • 是否支持电子票,0:不支持;1:支持
  • └ last_depart_time
  • String
  • 2021-05-19 00:00:00
  • 最晚出发时间
  • └ last_place_name
  • String
  • 临湘
  • 到达城市
  • └ pre_order
  • Boolean
  • false
  • 是否是预约购票订单
  • └ real_name_grade
  • String
  • 2|3|4
  • 实名制校验规则,'|'分隔,例如2|3|4;1 不需要进行实名制校验;2 订单内乘客身份证不能重复;3 当天同一班次乘客身份证限购1张票;4 同一取票人身份证当天限购3张票;5 同一乘车人身份证1天在该网站只能买1张票;6 取票人的姓名、证件信息必须在乘车人中
  • └ service_price
  • Number
  • 1
  • 服务费
  • └ shift_type
  • Number
  • 0
  • 流水班次 0 固定班次 1:流水班次 null 固定班次
  • └ spend_time
  • Number
  • 30
  • 耗时,单位:分钟,30分钟为单位向上取整
  • └ standard_city_name
  • String
  • 临湘
  • 标准城市名称
  • └ status
  • Number
  • 1
  • 状态 1:可售 2:不可售,非车站营业时间 3:不可售,超出预售期 4:暂停售卖
  • └ stock
  • Number
  • 90
  • 余票
  • └ via_station
  • String
  • 廊坊,天津
  • 路线信息(途径站:"廊坊,天津")
  • └ via_station_type
  • Number
  • 0
  • 途经站类型 0 未知 1 途经站 2 终点站
  • └ dep_city
  • String
  • 临湘
  • 出发城市
  • └ dep_date
  • String
  • 2021-05-19
  • 出发日期
  • └ dep_stations
  • String []
  • ["省汽车客运站","天河客运站"]
  • 所有出发车站
  • └ en_large
  • Number
  • 0
  • 是否放大搜索 0 没有 1 放大出发 2 放大到达
  • name_same_city
  • NameSameCityVo
  • module
  • 重名的城市
  • from_city_list
  • CityVo []
  • []
  • 来自城市
  • └ city
  • String
  • 123
  • 城市
  • └ code
  • String
  • 123
  • 城市code
  • └ name
  • String
  • 123
  • 城市名称
  • └ province
  • String
  • 湖北
  • 所属省份
  • to_city_list
  • CityVo []
  • []
  • 到达城市
  • └ city
  • String
  • 123
  • 城市
  • └ code
  • String
  • 123
  • 城市code
  • └ name
  • String
  • 123
  • 城市名称
  • └ province
  • String
  • 湖北
  • 所属省份
  • └ pre_order
  • Boolean
  • false
  • 是否是预约购票订单
  • recommend_routes
  • RouteVo []
  • []
  • 推荐的路线
  • └ from_city
  • String
  • 临湘
  • 来自城市
  • └ to_city
  • String
  • 临湘
  • 到达城市
  • station_latitude_longitudes
  • StationLatitudeLongitudeVo []
  • []
  • 车站信息集合
  • └ latitude
  • String
  • 123.123
  • 车站经度
  • └ longitude
  • String
  • 123.123
  • 车站纬度
  • └ poi_picture_url_list
  • String []
  • ["123"]
  • 目的地频道提供的景点图片url(会有多张图片)
  • └ poi_tag_list
  • String []
  • ["123"]
  • 目的地频道提供的标签(可能会有多个标签)
  • └ station_address
  • String
  • 123
  • 车站地址
  • └ station_name
  • String
  • 123
  • 车站名
  • └ station_tel
  • String
  • 123
  • 车站电话
  • └ tour_station_type
  • String
  • 00
  • 00去程上车点,01去程下车点,10返程上车点,11返程下车点
  • └ to_station_names
  • String []
  • []
  • 到达站列表
  • └ total
  • Number
  • 20
  • 车次数量
  • └ result_code
  • Number
  • 0
  • 返回码
  • └ result_msg
  • String
  • 成功
  • 返回信息
  • └ is_success
  • Boolean
  • true
  • 成功标识

请求示例

  • JAVA
  • .NET
  • PHP
  • CURL
  • Python
  • C/C++
  • NodeJS
TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlitripBtripSupplychainBusIndustrySearchRequest req = new AlitripBtripSupplychainBusIndustrySearchRequest();
AlitripBtripSupplychainBusIndustrySearchRequest.BusSearchRq obj1 = new AlitripBtripSupplychainBusIndustrySearchRequest.BusSearchRq();
obj1.setArrCity("临湘");
obj1.setArriveCityName("临湘,房县");
obj1.setDepCity("临湘");
obj1.setDepDate("2021-05-19");
obj1.setFromStationName("天河客运站,越秀南客运站");
obj1.setPeriodTime("1,2");
obj1.setScene("common");
obj1.setShowNoSell(0L);
obj1.setStandardFromAreaCode("123");
obj1.setStandardFromStationId(123L);
obj1.setStandardFromStationName("天河客运站");
obj1.setStandardToAreaCode("123");
obj1.setToStationName("省汽车客运站,天河客运站,越秀南客运站");
obj1.setCorpId("123");
obj1.setPageIndex(1L);
obj1.setPageSize(50L);
req.setRq(obj1);
AlitripBtripSupplychainBusIndustrySearchResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

响应示例

  • XML示例
  • JSON示例
<alitrip_btrip_supplychain_bus_industry_search_response>
    <result>
        <module>
            <arr_city>临湘</arr_city>
            <bus_lines>
                <bus_line_info_vo>
                    <arr_station>天河客运站</arr_station>
                    <arrival_time>2021-05-19 00:00:00</arrival_time>
                    <bus_distance>100</bus_distance>
                    <bus_no_id>111</bus_no_id>
                    <bus_number>11</bus_number>
                    <bus_number_uuid>123</bus_number_uuid>
                    <bus_type>123</bus_type>
                    <dep_city>临湘</dep_city>
                    <dep_station>省汽车客运站</dep_station>
                    <depart_time>2021-05-19 00:00:00</depart_time>
                    <extra_schedule>false</extra_schedule>
                    <full_price>100</full_price>
                    <half_price>100</half_price>
                    <is_support_e_ticket>0</is_support_e_ticket>
                    <last_depart_time>2021-05-19 00:00:00</last_depart_time>
                    <last_place_name>临湘</last_place_name>
                    <pre_order>false</pre_order>
                    <real_name_grade>2|3|4</real_name_grade>
                    <service_price>1</service_price>
                    <shift_type>0</shift_type>
                    <spend_time>30</spend_time>
                    <standard_city_name>临湘</standard_city_name>
                    <status>1</status>
                    <stock>90</stock>
                    <via_station>廊坊,天津</via_station>
                    <via_station_type>0</via_station_type>
                </bus_line_info_vo>
            </bus_lines>
            <dep_city>临湘</dep_city>
            <dep_date>2021-05-19</dep_date>
            <dep_stations>
                <string>[&quot;省汽车客运站&quot;</string>
                <string>&quot;天河客运站&quot;]</string>
            </dep_stations>
            <en_large>0</en_large>
            <name_same_city>
                <from_city_list>
                    <city_vo>
                        <city>123</city>
                        <code>123</code>
                        <name>123</name>
                        <province>湖北</province>
                    </city_vo>
                </from_city_list>
                <to_city_list>
                    <city_vo>
                        <city>123</city>
                        <code>123</code>
                        <name>123</name>
                        <province>湖北</province>
                    </city_vo>
                </to_city_list>
            </name_same_city>
            <pre_order>false</pre_order>
            <recommend_routes>
                <route_vo>
                    <from_city>临湘</from_city>
                    <to_city>临湘</to_city>
                </route_vo>
            </recommend_routes>
            <station_latitude_longitudes>
                <station_latitude_longitude_vo>
                    <latitude>123.123</latitude>
                    <longitude>123.123</longitude>
                    <poi_picture_url_list>
                        <string>[&quot;123&quot;]</string>
                    </poi_picture_url_list>
                    <poi_tag_list>
                        <string>[&quot;123&quot;]</string>
                    </poi_tag_list>
                    <station_address>123</station_address>
                    <station_name>123</station_name>
                    <station_tel>123</station_tel>
                    <tour_station_type>00</tour_station_type>
                </station_latitude_longitude_vo>
            </station_latitude_longitudes>
            <to_station_names>
                <string>[]</string>
            </to_station_names>
            <total>20</total>
        </module>
        <result_code>0</result_code>
        <result_msg>成功</result_msg>
        <is_success>true</is_success>
    </result>
</alitrip_btrip_supplychain_bus_industry_search_response>

异常示例

  • XML示例
  • JSON示例
<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

错误码解释

错误码 错误描述 解决方案

API工具

如何获得此API

FAQ

返回
顶部