酒店分房项目API

会务酒店分房工具API

通用参数

  • 状态码code的含义

{
  0：请求成功
  1：操作失败
}

  • 所有的API请求都要携带token参数

{
  access_token:  访问token
  access_type:  token类型
}

新建工具

API

[POST] /tool_hotel
<span id="tool_content"></span>

请求参数

参数 类型 允许为空 描述
background String 否 背景图片链接
tool_title String 否 工具标题
tool_desc String 否 工具描述
permission String 是 限定的会议ID
agency_id String 否 机构ID
open_time int 否 开始时间
close_time int 否 截止时间
form_config Array 否 表单配置

form_config数组数据项格式：

参数 类型 允许为空 描述
type String 否 表单类型
category String 否 表单分类
name String 否 字段名称
desc String 否 字段描述
tips String 否 字段提示
picked_for_allocate String 否 是否勾选为分配规则
options Array 否 单选和多选类型的选择项
required String 否 是否必填,值为true 或者 false
default String 否 是否默认,值为true 或者 false

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data int 是 工具ID

Sample

[POST] http://localhost:9999/tool_hotel?access_token=xxx&access_type=org

Body:

{
  "tool_title": "第二届中国浙商会议酒店用房预订",
  "background": "http://pic2.cxtuku.com/00/02/31/b945758fd74d.jpg”,
  "tool_desc":"",
  "permission": "",
  "agency_id": "非空",
  "open_time":"开始时间",
  "close_time":"关闭时间",
  "form_config":[
    {
      type:"xxx",
      name:"",
      desc:"",
      tips:"",
      options:[],
      required:"true",
      default:"true"
    }
  ]
}

Return:

{
  "code": 0,
  "msg": "创建成功",
  "data": “1”
}

查询工具内容

API

[GET] /tool_hotel/{id}

请求参数

参数 类型 允许为空 描述
access_token String 否 访问凭证
access_type String 否 凭证类型

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data Object 是 返回数据

Data:

参数 类型 允许为空 描述
id int 否 工具ID
其它参数同 创建工具时提交的参数

更新工具内容

API

[PUT] /tool_hotel/{id}

请求参数

参数 类型 允许为空 描述
id int 否 工具ID
其它参数同 创建工具时提交的参数

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data int 是 工具 ID

Return:

{
  "code": 0,
  "msg": "更新成功",
  "data": “1”
}

删除工具

API

[DELETE] /tool_hotel/{id}

请求参数

参数 类型 允许为空 描述
access_token String 否 访问凭证
access_type String 否 凭证类型

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 是 工具 ID

获取excel模板

API

[get] /tool_hotel/{id}/excel_template

返回

excel表import_members_template.xlsx

批量上传会员信息

API

[POST] /tool_hotel/{id}/batch_members

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data int 是 工具ID

读取预约或待分配会员列表

API

[get] /tool_hotel/{id}/member_list/{select}

select :

unbook:未预约
unassigned:未分配

请求参数

参数 类型 允许为空 描述
page_index int 否 页码，默认是1，当值为0时则不分页
page_size int 否 每页大小，默认是10
name int 否 会员名字

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data Array 是 会员列表

data 数组数据项格式：

参数 类型 允许为空 描述
member_id String 否 会员ID
member_real_name String 否 会员名字
member_sex String 否 会员性别
member_phone String 否 会员手机号码
member_IDnum String 否 身份证号码
room_type String 否 选择房型
member_checkin_date String 否 入住时间
member_checkout_date String 否 退房时间
hotel String 否 选择酒店
member_extra String 否 会员提交的其它信息
member_status String 否 会员的分房状态
pre_room_num String 否 预分配编号
remark_room_num String 否 备注房间号
send_msg_status String 否 发送消息状态

读取已分配会员列表

API

[get] /tool_hotel/{id}/member_list/assigned

请求参数

参数 类型 允许为空 描述
page_index int 否 页码，默认是1
page_size int 否 每页大小，默认是10
name int 否 会员名字

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data Array 是 会员列表

data 数组数据项格式：

参数 类型 允许为空 描述
pre_room_num String 否 预订编号
room_type String 否 房型
room_members String 否 房间成员
room_checkin_date String 否 入住时间
room_checkout_date String 否 离店时间

根据住房时间读取未分配会员列表

API

[get] /tool_hotel/{id}/member_list/unallocate/from/{checkin_date}/to/{checkout_date}

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data Array 是 会员列表

data 数组数据项格式：

参数 类型 允许为空 描述
member_id String 否 会员ID
member_real_name String 否 会员名字
member_sex String 否 会员性别
member_phone String 否 会员手机号码
member_IDnum String 否 身份证号码
room_type String 否 选择房型
member_checkin_date String 否 入住时间
member_checkout_date String 否 退房时间
can_share String 否 是否分房
hotel String 否 选择酒店
remarks String 否 备注
member_extra String 否 会员提交的其它信息
member_status String 否 会员的分房状态

导出会员列表

API

[GET] /tool_hotel/{id}/member_list_export/{select}
select :

unbook:未预约
unassigned:未分配
assigned:已分配

返回

excel表 member-list-{select}.xlsx

添加待预约会员

API

[POST] /tool_hotel/{id}/member/unbook

请求参数

参数 类型 允许为空 描述
member_real_name String 否 会员名字
member_phone String 否 会员手机号码

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 是 会员ID

添加待分配会员

API

[POST] /tool_hotel/{id}/member/unallocate

请求参数

<span id="add_member"></span>

参数 类型 允许为空 描述
member_real_name String 否 会员名字
member_sex String 否 会员性别
member_phone String 否 会员手机号码
member_IDnum String 否 身份证号码
room_type String 否 选择房型
member_checkin_date String 否 入住时间
member_checkout_date String 否 退房时间
can_share String 否 是否拼房
hotel String 是 选择酒店，没有酒店选择，传空字符串
remarks String 是 备注
member_extra String 是 非默认表单数据（把对象转为json字符串)

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 是 会员ID

查询会员信息

API

[GET] /tool_hotel/{id}/member/{id}

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data Object 是 会员信息

data格式:

参数 类型 允许为空 描述
pre_room_num String 否 预订编号
remark_room_num String 否 备注房间号
其它参数同 添加待分配会员接口提交的参数

修改会员信息

API

[PUT] /tool_hotel/{id}/member/{id}
请求参数和返回结果同会员提交预约订房信息

会员提交预约订房信息

API

[PUT] /tool_hotel/{id}/book_room

请求参数

参数 类型 允许为空 描述
pre_room_num String 否 预订编号
remark_room_num String 否 备注房间号
其它参数同 添加待分配会员接口提交的参数

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 是 会员ID

code :

{
   0:   成功
   1：不在预约列表
   2：已在分配列表
}

删除会员

API

[DELETE] /tool_hotel/{id}/member/{id}

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 是 会员ID

给会员发送预订短信

API

[PUT] /tool_hotel/{id}/member/{id}/message_book

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 否 会员手机号

给所有会员发送预订短信

API

[PUT] /tool_hotel/{id}/message_book/to_all

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 否 工具ID

给所有会员发送成功短信通知

API

[PUT] /tool_hotel/{id}/message_allocated/to_all

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 否 工具ID

查询已分配房间信息

[GET] /tool_hotel/{id}/allocated_room_info/{pre_room_num}

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data Object 否 会员手机号

data 数据格式：
<span id="allocated_room_info"></span>

参数 类型 允许为空 描述
pre_room_num int 否 预订编号
room_type String 是 房间类型
member_checkin_date String 否 入住时间
member_checkout_date String 否 离店时间
remark_room_num String 否 标记的房间号
room_members Array 否 房间成员

room_members数组数据格式：

参数 类型 允许为空 描述
member_id int 否 会员ID
member_real_name String 否 会员名字

修改已分配房间信息

[PUT] /tool_hotel/{id}/allocated_room_info/{pre_room_num}

请求参数

参数 类型 允许为空 描述
参数同 查询已分配房间信息返回参数

清除已分配房间

[DELETE] /tool_hotel/{tool_id}/clear_room_member/{pre_room_num}

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 是 预订房间编号

设置分房规则

API

[PUT] /tool_hotel/{id}/allocate_rule

请求参数

参数 类型 允许为空 描述
rules Array 否 分房规则

rules数组的数据项格式：

参数 类型 允许为空 描述
id Int 否 规则ID
name String 否 规则名称
picked_for_allocate String 否 是否被勾选了,true:是，false:否

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data String 是 工具ID

读取分房规则

API

[GET] /tool_hotel/{id}/allocate_rule

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data Array 是 分房规则

data数组的数据项格式：

参数 类型 允许为空 描述
id Int 否 规则ID
name String 否 规则名称
picked_for_allocate String 否 是否被勾选了,true:是，false:否

批量分配房间

API

[PUT] /tool_hotel/{id}/batch_allocate

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data int 是 工具ID

读取分房统计

API

[GET] /tool_hotel/{id}/allocate_stat

返回参数

参数 类型 允许为空 描述
code int 否 状态码
msg String 是 描述文字
data array 是 分类统计结果

data数组数据项格式：

[
            {
                category: '预订会员统计',
                stat: {
                    "预约会员数量": book_member_num,
                    "待分配会员数量": unallocated_member_num,
                    "已分配会员数量": allocated_member_num,
                    "会员总数":member_num
                }
            },
            {
                category: '预订房间统计',
                stat: {
                    "预约标准单人房间数量": book_singleroom_num,
                    "预约标准双人房间数量": book_doubleroom_num,
                    "预约房间总数量": book_room_num
                }
            },
            {
                category: '房间分配统计',
                stat: {
                    "已分配标准单人房间数量": allocated_singleroom_num,
                    "未分配标准单人房间数量": unallocated_singleroom_num,
                    "已分配标准双人房间数量": allocated_doubleroom_num,
                    "未分配标准双人房间数量": unallocated_doubleroom_num,
                    "已分配房间数量": allocated_room_num,
                    "未分配房间数量": unallocated_room_num
                }
            }
 ]
最后编辑于 ：
©著作权归作者所有,转载或内容合作请联系作者
  • 人面猴
    序言：七十年代末，一起剥皮案震惊了整个滨河市，随后出现的几起案子，更是在滨河造成了极大的恐慌，老刑警刘岩，带你破解...
    沈念sama阅读 204,684评论 6赞 478
  • 死咒
    序言：滨河连续发生了三起死亡事件，死亡现场离奇诡异，居然都是意外死亡，警方通过查阅死者的电脑和手机，发现死者居然都...
    沈念sama阅读 87,143评论 2赞 381
  • 救了他两次的神仙让他今天三更去死
    文/潘晓璐 我一进店门，熙熙楼的掌柜王于贵愁眉苦脸地迎上来，“玉大人，你说我怎么就摊上这事。” “怎么了？”我有些...
    开封第一讲书人阅读 151,214评论 0赞 337
  • 道士缉凶录：失踪的卖姜人
    文/不坏的土叔 我叫张陵，是天一观的道长。 经常有香客问我，道长，这世上最难降的妖魔是什么？ 我笑而不...
    开封第一讲书人阅读 54,788评论 1赞 277
  • 港岛之恋（遗憾婚礼）
    正文 为了忘掉前任，我火速办了婚礼，结果婚礼上，老公的妹妹穿的比我还像新娘。我一直安慰自己，他们只是感情好，可当我...
    茶点故事阅读 63,796评论 5赞 368
  • 恶毒庶女顶嫁案：这布局不是一般人想出来的
    文/花漫 我一把揭开白布。 她就那样静静地躺着，像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上，一...
    开封第一讲书人阅读 48,665评论 1赞 281
  • 城市分裂传说
    那天，我揣着相机与录音，去河边找鬼。 笑死，一个胖子当着我的面吹牛，可吹牛的内容都是我干的。 我是一名探鬼主播，决...
    沈念sama阅读 38,027评论 3赞 399
  • 双鸳鸯连环套：你想象不到人心有多黑
    文/苍兰香墨 我猛地睁开眼，长吁一口气：“原来是场噩梦啊……” “哼！你这毒妇竟也来了？” 一声冷哼从身侧响起，我...
    开封第一讲书人阅读 36,679评论 0赞 258
  • 万荣杀人案实录
    序言：老挝万荣一对情侣失踪，失踪者是张志新（化名）和其女友刘颖，没想到半个月后，有当地人在树林里发现了一具尸体，经...
    沈念sama阅读 41,346评论 1赞 299
  • 护林员之死
    正文 独居荒郊野岭守林人离奇死亡，尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,664评论 2赞 321
  • 白月光启示录
    正文 我和宋清朗相恋三年，在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,766评论 1赞 331
  • 活死人
    序言：一个原本活蹦乱跳的男人离奇死亡，死状恐怖，灵堂内的尸体忽然破棺而出，到底是诈尸还是另有隐情，我是刑警宁泽，带...
    沈念sama阅读 33,412评论 4赞 321
  • 日本核电站爆炸内幕
    正文 年R本政府宣布，位于F岛的核电站，受9级特大地震影响，放射性物质发生泄漏。R本人自食恶果不足惜，却给世界环境...
    茶点故事阅读 39,015评论 3赞 307
  • 男人毒药：我在死后第九天来索命
    文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹，春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,974评论 0赞 19
  • 一桩弑父案，背后竟有这般阴谋
    文/苍兰香墨 我抬头看了看天上的太阳。三九已至，却和暖如春，着一层夹袄步出监牢的瞬间，已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,203评论 1赞 260
  • 情欲美人皮
    我被黑心中介骗来泰国打工， 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留，地道东北人。 一个月前我还...
    沈念sama阅读 45,073评论 2赞 350
  • 代替公主和亲
    正文 我出身青楼，却偏偏与公主长得像，于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子，可洞房花烛夜当晚...
    茶点故事阅读 42,501评论 2赞 343

推荐阅读更多精彩内容

  • Java初级面试题
    1. Java基础部分 基础部分的顺序：基本语法，类相关的语法，内部类的语法，继承相关的语法，异常的语法，线程的语...
    子非鱼_t_阅读 31,572评论 18赞 399
  • Spring Cloud
    Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具（例如配置管理，服务发现，断路器，智...
    卡卡罗2017阅读 134,596评论 18赞 139
  • 面向对象的用电信息数据交换协议
    国家电网公司企业标准（Q/GDW）- 面向对象的用电信息数据交换协议 - 报批稿：20170802 前言： 排版 ...
    庭说阅读 10,863评论 6赞 13
  • 抽奖活动API
    抽奖活动API 获取参与抽奖名单 分页获取参与抽奖名单 导出参与名单的报表模板 导入参与名单 内定中奖名单列表 获...
    kingsonCai阅读 2,503评论 1赞 1
  • 学习与我来说意味着什么
    昨晚和老公一大家子吃饭，席间谈起表哥，二姨家的孩子，大家不约而同的表示对他操碎了心。一直以来这位表哥的行事总是神秘...
    发条君的简书阅读 1,938评论 0赞 0