文档中心 > 综合交通-商家对接

qimen.alitrip.bus.product.queryseat (查询余票)

汽车票查询余票

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
fromCityName String 可选 北京 出发城市名称
fromCityCode String 可选 C001 出发城市编码
toStationName String 必须 古北水镇 到达名称
departDate String 可选 2018-08-08 出发日期
busNumberList BusNumber [] 必须
  • 最大列表长度:999
  • 班次信息
    • └ departTime
    • String
    • 必须
    • 2018-08-08 08:00:00
    • 发车时间
    • └ scheduleId
    • String
    • 必须
    • 123456789
    • 班次id
    • └ goodsId
    • String
    • 必须
    • 99988800
    • 商品id
    • └ busNumber
    • String
    • 可选
    • b001
    • 航线班次号
    • └ specialTicketCode
    • String
    • 可选
    • student
    • 特殊票种code

    响应参数

    名称 类型 示例值 描述
    retCode String 0 错误码
    retDesc String 成功 错误描述
    busSeatList BusSeat [] 列表(必填)
    • └ busNumber
    • String
    • 1111
    • 班次号
    • └ distance
    • Number
    • 380
    • 历程(单位公里)
    • └ remainSeats
    • Number
    • 30
    • 余票数(是必填)
    • └ startCityCode
    • String
    • 001
    • 出发城市编号(code定位时必填)
    • └ startCityName
    • String
    • 北京
    • 出发城市名称(name定位时必填)
    • └ lastPlaceName
    • String
    • 石家庄
    • 到达名称(是必填)
    • └ startTimestamp
    • String
    • 2014-12-02 16:23:23
    • 发车时间(是必填)
    • └ scheduleId
    • String
    • 22104DC8D66FE5B6C97F508154CD8F20
    • 车次id(是必填)
    • └ goodsId
    • String
    • 001
    • 商品id(是必填)
    • └ specialTicketCode
    • String
    • student
    • 特殊票种code(选填)
    • └ fullPrice
    • Number
    • 60
    • 全价(单位分)(是必填)
    • └ originPrice
    • Number
    • 原始价格
    • 促销字段选填(单位分)
    • └ halfPrice
    • Number
    • 30
    • 半票价(单位分)
    • └ servicePrice
    • Number
    • 100
    • 服务费(单位分)
    • └ supportChild
    • Boolean
    • true
    • 是否支持儿童票
    • └ supportWithChild
    • Boolean
    • true
    • 是否支持携童票
    • └ withChildStock
    • String
    • 4
    • 携童票库存
    success Boolean true 业务是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlitripBusProductQueryseatRequest req = new AlitripBusProductQueryseatRequest();
    req.setFromCityName("北京");
    req.setFromCityCode("C001");
    req.setToStationName("古北水镇");
    req.setDepartDate("2018-08-08");
    List<AlitripBusProductQueryseatRequest.BusNumber> list2 = new ArrayList<AlitripBusProductQueryseatRequest.BusNumber>();
    AlitripBusProductQueryseatRequest.BusNumber obj3 = new AlitripBusProductQueryseatRequest.BusNumber();
    list2.add(obj3);
    obj3.setDepartTime("2018-08-08 08:00:00");
    obj3.setScheduleId("123456789");
    obj3.setGoodsId("99988800");
    obj3.setBusNumber("b001");
    obj3.setSpecialTicketCode("student");
    req.setBusNumberList(list2);
    AlitripBusProductQueryseatResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <retCode>0</retCode>
    <retDesc>成功</retDesc>
    <busSeatList>
        <bus_seat>
            <busNumber>1111</busNumber>
            <distance>380</distance>
            <remainSeats>30</remainSeats>
            <startCityCode>001</startCityCode>
            <startCityName>北京</startCityName>
            <lastPlaceName>石家庄</lastPlaceName>
            <startTimestamp>2014-12-02 16:23:23</startTimestamp>
            <scheduleId>22104DC8D66FE5B6C97F508154CD8F20</scheduleId>
            <goodsId>001</goodsId>
            <specialTicketCode>student</specialTicketCode>
            <fullPrice>60</fullPrice>
            <originPrice>原始价格</originPrice>
            <halfPrice>30</halfPrice>
            <servicePrice>100</servicePrice>
            <supportChild>true</supportChild>
            <supportWithChild>true</supportWithChild>
            <withChildStock>4</withChildStock>
        </bus_seat>
    </busSeatList>
    <success>true</success>
    

    异常示例

    • 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

    返回
    顶部