Hotel confirm V1/order/hotel confirm
功能说明
酒店确认订单
URL
http://[域名]/v1_6/order/hotel_confirm
返回格式
支持json,xml.通过format参数来控制
HTTP请求方式
POST.可以post的数据为xml或json.
输入参数说明
各个参数请进行URL 编码,编码时请遵守 RFC 1738 (1)公共参数 发送请求时必须传入公共参数,详见公共参数说明。 (2)私有参数
参数名称 | 是否必须 | 类型 | 描述 |
---|---|---|---|
ticket_id |
必须 | int | 票种ID |
target_date |
否 |
string |
出行时间,格式为‘2015-07-07’ |
version | 是 |
string |
版本号 |
is_partner |
是 |
int |
是否结伴:1是0否(3.10版本新增) |
uid |
是 |
int |
用户id(3.10版本新增) |
need_receiver |
否 |
int |
是否需要收货人:0否1是 |
请求示例
正式环境 http://api.fumubang.com/v1_6/order/hotel_confirm 测试环境 http://api.fumubang.net/v1_6/order/hotel_confirm 本地环境 http://dev-api.fumubang.net/v1_6/order/hotel_confirm
返回参数说明
参数 | 说明 |
---|---|
title |
活动名称 |
aid |
活动ID |
shop_address |
商家地址 |
package_id |
套餐ID |
package_name |
套餐名称 |
package_brief |
套餐简介 |
package_desc |
套餐内容 |
package_night_num |
套餐晚数 |
ticket_id |
票种ID |
hotel_type_name |
房型名称 |
bed_type_list |
房型安排 |
image |
房型图 |
limit_min |
最小购买数 |
limit_max |
最大购买数 |
mintime |
日历最小日期 |
maxtime |
日历最大日期 |
date_price |
日历价格列表 |
summary |
购买说明 |
extend_field |
套餐里的附加表单 |
hotel_scenery |
酒+景的景点票列表 |
package_id |
套餐id |
ticket_id |
景点票种id |
num |
景点票种数量 |
tname |
景点票种名称 |
people_num |
身份证数量 |
scenery_time |
景点票游玩时间,以‘,’分隔 |
bed_date_list |
床型对应的5个酒店套餐晚数的列表 |
receiver |
收货人列表(3.10新增) |
mobile |
收货人手机号(3.10新增) |
date_goods_price |
当target_date不为空,且为结伴订单时,该值返回酒店target_date对应的现价,根据这个值和结伴价相减就是结伴优惠 |
discount_des |
优惠描述(3.37新增) |
money_type |
优惠类型 1-减少 2-不变 3-增加 (3.37新增) |
正确返回示例
{
"title": "shuwen测试活动----l----酒店",
"aid": "100611",
"sell_limit_time": "129600",
"shop_address": "北京市朝阳区朝阳北路常营公园",
"package_id": "27",
"extend_field": [
{
"extend_name": "身份证",
"extend_value": "",
"require": 1,
"extend_validate": "^(\\d{15}$|^\\d{18}$|^\\d{17}(\\d|X|x))$"
}],
"package_name": "小套餐",
"package_brief": "小套餐",
"package_desc": "小套餐",
"package_have": "array (\n 0 => \\'breackfast\\',\n)",
"package_night_num": "1",
"ticket_id": "2497",
"hotel_type_name": "小房",
"bed_type_list": [ //所选日期当天可选床型
{
"type": "double",
"bed_require": "尽量安排双床"
}
],
"image": "http://img.fumubang.net/house_type/20150106/20150106144836935.jpg",
"limit_min": "1",
“people_num”:"1",
"hotel_scenery": [ //v3.90版本返回如下,单独列出。
{
"package_id": "99",
"ticket_id": "3441",
"num": "2",
"tname": "景点门票"
},
{
"package_id": "99",
"ticket_id": "3453",
"num": "1",
"tname": "saa"
}
],
"bed_date_list": [//续住时日期床型对照表
{
"date": "2015-09-12",//日期
"bed_list": [//床型列表
{
"type": "double",
"bed_require": "双床房"
},
{
"type": "single",
"bed_require": "单床房"
}
]
},
{
"date": "2015-09-16",
"bed_list": [
{
"type": "double",
"bed_require": "双床房"
},
{
"type": "single",
"bed_require": "单床房"
}
]
},...
]
"goods_price": "0.02",
"limit_max": "20",
"scenery_time":"2015-09-22,2015-09-23",//景点票游玩时间
"mintime": "2015-02-01",
"maxtime": "2015-02-04",
"date_price": "2015-02-01:0.02:50,2015-02-02:0.02:50,2015-02-03:0.02:50,2015-02-04:0.02:50", //日期:当日价格:当日库存
"date_goods_price": "180.00",
"discount_des": "如果结伴的话,表面上看价格是一样的,实际上优惠可大了,送好多东西,不管你信不信吧,反正我是不信,哈哈哈哈哈哈哈哈哈哈哈", //3.37新增 优惠描述
"money_type": "2" //3.37新增 优惠类型 1-减少 2-不变 3-增加
}
v3.90酒店确认订单由酒加景衍生为酒加X,故结构做出以下调整:
"hotel_scenery": [{
"aid": "104085",
"activity_name": "joanna_酒+景专用景点票 ddd",
"ticket_group_id": "3517",
"package_id": "321",
"ticket_type": "2",
"tickets": [{
"ticket_id": "20259",
"tname": "票种a",
"num": "1"
},
{
"ticket_id": "20265",
"tname": "酒加景专用b",
"num": "1"
}
],
"scenery_time": "2018-07-27,2018-07-28"
},
{
"aid": "104395",
"activity_name": "sam's预约通用票活动",
"ticket_group_id": "3771",
"package_id": "321",
"ticket_type": "3",
"tickets": [{
"ticket_id": "23633",
"tname": "成人票",
"num": "2",
"attr": [{
"key": "票种",
"value": "成人票"
},
{
"key": "有效期",
"value": "2018.06.04至2019.06.04"
}
]
}]
}
错误返回示例
<syntaxhighlight lang="php"> <error_code>100001</error_code> <error_msg>签名失败</error_msg> </syntaxhighlight>