接口说明
### 接口说明
- 旅业助手对外接口分为输入模式和输出模式;
1. **输入模式** 客人信息输入在第三方Pms或自助开房系统,第三方系统在办理业务时,将客人的入住,换房,续住以及退房信息通过接口输入给旅业助手,由旅业助手完成数据的分发及公安上传。
2. **输出模式** 客人信息有旅业助手进行采集输入,第三方Pms或自助开房系统通过接口获取客人的信息;
**两种模式均支持文件交互方式和API接口方式;**
接口配置界面如下:

## Api接口信息文档
### 编码
若请求消息体中的参数支持中文,则中文字符必须为UTF-8编码。
### 时间与日期
表示日期一律采用YYYY-MM-DD方式,例如2020-06-01表示2016年6月1日
表示时间一律采用hh:mm:ss方式,
凡涉及日期和时间合并表示时,在两者中间加空格,例如2020-06-01 23:00:10 表示UTC时间2020年6月1日23点0分10秒
### ToKen
联系软件供应商获取有效ToKen信息,在每次调用中均需要携带ToKen信息
### 旅业助手 API 规格
- 公共请求消息头
下表列出了所有接口所携带的公共头域。HTTP 协议的标准头域不再这里列出了。
|消息头(Header)|是否必须|说明|
|-|-|-|
|Content-Type|可选|application/json; charset=utf-8|
- 下表列出了所有接口的公共响应头域。HTTP协议的标准响应头域不再这里列出了
|消息头(Header)|说明|
|-|-|-|
|Content-Type|只支持JSON格式,application/json; charset=utf-8|
### 返回格式
统一为如下格式。后续各接口不再单独列出。
|参数名|类型|说明
|-|-|-|
|ResultCode|string|状态码|
|msg|string|说明|
示例
```json
{
"Msg": "成功",
"Gid": "L09110105803620035",
"ResultCode": 200
}
```
### 注意事项
- 入住成功后接口会返回宾客id “GuestID”,需保存该信息,修改信息和退房时需要提供宾客id;
- 换房,退房,修改预离时间时如果没有提供GuestID,需要提供RoomID和CardID两个参数,服务端会根据这两个参数在当前入住客人中检索GuestID;
- 退房时间 不可超过当前时间也不可小于入住时间;
#### 常见返回码
200: Result.s['Msg'] := '成功';
101: Result.s['Msg'] := '机构标识不正确';
102: Result.s['Msg'] := '校验码不正确';
103: Result.s['Msg'] := 'ToKen错误';
104: Result.s['Msg'] := 'ToKen超时';
199: Result.s['Msg'] := '其他错误';
404: Result.s['Msg'] := '没找到对应的接口';
### 测试信息
机构标识:091101058036
校验码:091101058036
工作站:Api测试
工号:101
密码:888
ToKen:B9D92A6AAAEA2D6D97F7187898
### 测试房间号
1701
1702
1703
1704
1705
1706
1707
1708
1709
1710
1711
1712
1714
1715
1716
1717
1718
1719
1720
1721
1723
1724
1725
1727
1729
1730