API列表
城市列表
酒店列表
静态信息详情
报价接口
订单报价接口
创建订单
取消订单
查询订单

创建订单

请求方式:http,返回json格式。
订单30秒视为超时。
请求多天数的订单,每天取消规则不同时,以最严格的那天为准。

接口地址

名称 请求格式 测试地址
创建订单 POST http://58.250.56.211:8081/api/order/createOrder.json?reqData=xxx

系统输入参数

名称 编码 类型 示例值 描述
客户编号 appKey String SZ28276 捷旅提供
房间数量 roomNum Integer 2 几个RoomGroup就是对应几间房
时间戳 timestamp String 1516816895000 Unix时间戳
数字签名 sign String 063cae11a00896187f80eecbf922364a 签名方法:md5(md5(secretKey+appKey)+timestamp)md5采用32位小写。
版本 version String 3.0.1 版本信息,请参考版本说明

系统输出参数

名称 编码 类型 示例值 描述
结果代码 code Integer 0 0表示请求成功;非0表示存在业务异常。
结果描述 errorMsg String 错误描述
版本 version String 3.0.1
结果对象 result String 不同的请求是不同的对象,错误的请求一般返回为空
响应码 respId String 单次响应的唯一编码,业务问题排查请提供编码

输入参数

名称 编码 类型 是否必填 示例值 描述
客户订单号 customerOrderCode String
酒店编号 hotelId Integer
产品编号 keyId String
入住日期 checkInDate String yyyy-MM-dd
离店日期 checkOutDate String yyyy-MM-dd
每日价格 nightlyPrices String 200.58|120.6|120.8
总金额 totalPrice Double
房间信息 roomGroups RoomGroup[] 常用设置为1个房间2个成人,几个RoomGroup就是对应几间房
给酒店备注 hotelRemark String

RoomGroup

对象包括房间入住信息。

属性

名称 编码 类型 是否必填 示例值 描述
入住人姓名 checkInPersions CheckInPersion[]
成人数 adults Integer 默认:入住人姓名对象size
儿童数 children Integer
儿童年龄 childAges String 儿童年龄(多个时用逗号分割)。年龄的个数需要和儿童数保持一致

CheckInPersion

对象包括房间入住姓名。

属性

名称 编码 类型 是否必填 示例值 描述
入住人的姓 lastName String 不能包含特殊字符
入住人的名 firstName String 不能包含特殊字符
国籍 nationality String CHN 三位字母 参考http://doc.chacuo.net/iso-3166-1

输入示例

            	{"head":{"appKey":"SZ28276","timestamp":"1516816895000","sign":"063cae11a00896187f80eecbf922364a","version":"3.0.1"},"data":{"customerOrderCode":"R15644321358","hotelId":171870,"keyId":"SGS8GA#4A2SG#S2F262#S2F244#A||13#1318581569168081061#||EQW7PWEPEW","checkInDate":"2017-12-21","checkOutDate":"2017-12-23","nightlyPrices":"601|601","roomGroups":[{"adults":2,"checkInPersions":[{"lastName":"姓名","firstName":"test"}]}],"hotelRemark":"酒店备注","totalPrice":1202.0}}
            	

返回参数

名称 编码 类型 示例值 描述
订单编号 orderCode String JLA20118010978888
订单状态 orderStatus Integer 1:待确认、2:已确认、3:已拒单、4:已取消、5:已入住

返回示例

返回示例
            	{"code":0,"errorMsg":"","result":{"createOrder":{"orderCode":"JLA20118010955385","orderStatus":2}},"respId":"27c8689c-8fa1-4999-8e00-f6847df96ed1"}