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

qimen.alitrip.rail.trade.book (占座接口)

国际火车票商家占座接口

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
booking_code String [] 必须
  • 最大列表长度:999
  • 占座码
    seat_reserved Boolean 必须 false 是否定座
    contact Contact 必须 联系人信息
    • └ first_name
    • String
    • 可选
    • bing
    • └ last_name
    • String
    • 可选
    • chen
    • └ email
    • String
    • 必须
    • xx@sina.com
    • 邮箱
    • └ phone
    • String
    • 必须
    • 13011111111
    • 电话需要+86
    • └ name
    • String
    • 可选
    • 朱轩
    • 中文名
    passenger_list Passenger [] 必须
  • 最大列表长度:999
  • 乘客信息
    • └ birth_date
    • String
    • 必须
    • 2011-08-12
    • 出生日期yyyy-MM-dd
    • └ email
    • String
    • 可选
    • test@sina.com
    • 邮箱
    • └ first_name
    • String
    • 必须
    • bing
    • └ last_name
    • String
    • 必须
    • chen
    • └ gender
    • String
    • 必须
    • FEMALE
    • 性别FEMALE/MALE
    • └ passport
    • String
    • 必须
    • EX20211
    • 护照号
    • └ phone
    • String
    • 可选
    • 13000001111
    • 手机号需要+86
    tp_order_id Number 必须 123455 平台订单号
    attributes String 可选 aa 扩展字段

    响应参数

    名称 类型 示例值 描述
    result ResultSet 响应结果
    • module
    • BookRS
    • module
    • └ asyncKey
    • String
    • keyxxx
    • 异步key
    • └ isAsync
    • Boolean
    • false
    • 是否异步
    • └ agentOrderId
    • String
    • 123442
    • 代理商订单号(同步接口必须返回,异步接口如果没有返回异步key的话必须返回,有key的话可不返回也可不返回)
    • ticket_list
    • Ticket []
    • 票信息
    • └ ticket_id
    • String
    • ticektId
    • ticektId
    • └ from_station_name
    • String
    • 柏林
    • 出发站名
    • └ from_station_code
    • String
    • xxt
    • 出发站code
    • └ to_station_name
    • String
    • 米兰
    • 到达站名
    • └ to_station_code
    • String
    • xxa
    • 到达站code
    • └ ticket_price
    • Number
    • 100
    • 票价:(单位分)
    • └ payment_price
    • String
    • 2000
    • 总支付价:(单位分)
    • └ ticket_price
    • String
    • 2000
    • 票面总价:(单位分)
    • └ err_msg
    • String
    • 系统异常
    • 错误信息
    • └ err_code
    • String
    • sys-error
    • 错误码
    • └ success
    • Boolean
    • true
    • 是否成功

    请求示例

    • JAVA
    • .NET
    • PHP
    • CURL
    • Python
    • C/C++
    • NodeJS
    QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
    AlitripRailTradeBookRequest req = new AlitripRailTradeBookRequest();
    req.setBookingCode("");
    req.setSeatReserved(false);
    AlitripRailTradeBookRequest.Contact obj1 = new AlitripRailTradeBookRequest.Contact();
    obj1.setFirstName("bing");
    obj1.setLastName("chen");
    obj1.setEmail("xx@sina.com");
    obj1.setPhone("13011111111");
    obj1.setName("朱轩");
    req.setContact(obj1);
    List<AlitripRailTradeBookRequest.Passenger> list3 = new ArrayList<AlitripRailTradeBookRequest.Passenger>();
    AlitripRailTradeBookRequest.Passenger obj4 = new AlitripRailTradeBookRequest.Passenger();
    list3.add(obj4);
    obj4.setBirthDate("2011-08-12");
    obj4.setEmail("test@sina.com");
    obj4.setFirstName("bing");
    obj4.setLastName("chen");
    obj4.setGender("FEMALE");
    obj4.setPassport("EX20211");
    obj4.setPhone("13000001111");
    req.setPassengerList(list3);
    req.setTpOrderId(123455L);
    req.setAttributes("aa");
    AlitripRailTradeBookResponse rsp = client.execute(req);
    System.out.println(rsp.getBody());

    响应示例

    • XML示例
    • JSON示例
    <result>
        <module>
            <asyncKey>keyxxx</asyncKey>
            <isAsync>false</isAsync>
            <agentOrderId>123442</agentOrderId>
            <ticket_list>
                <ticket>
                    <ticket_id>ticektId</ticket_id>
                    <from_station_name>柏林</from_station_name>
                    <from_station_code>xxt</from_station_code>
                    <to_station_name>米兰</to_station_name>
                    <to_station_code>xxa</to_station_code>
                    <ticket_price>100</ticket_price>
                </ticket>
            </ticket_list>
            <payment_price>2000</payment_price>
            <ticket_price>2000</ticket_price>
        </module>
        <err_msg>系统异常</err_msg>
        <err_code>sys-error</err_code>
        <success>true</success>
    </result>
    

    异常示例

    • 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

    返回
    顶部