宾客业务办理
https://api.orbitaiot.com/open/v1/hotelguest/guestCheckIn
1. HTTP请求方法及示例
| POST /open/v1/hotelguest/guestCheckIn Host: api.orbitaiot.com Content-Type: application/json Authorization: Bearer eyJ0eXAiOiJKV1QiLCJhbGciOiJSUzI1NiJ9.eyJhdWQiOiIxNiIsImp0aSI6Ijg3MjYxNmExMGFlYzdmMmNlY2RhM2NiOGRhNWU0YTVhZTI1MjdmYmY5OGI1MzFiZDY0ZTkxYjBhYjQ3MTRmY2Q5MTNkNmRmNTQzYjllYmU4IiwiaWF0IjoxNzQxNjgyMTI3LCJuYmYiOjE3NDE2ODIxMjcsImV4cCI6MTc0NDM2MDUyNywic3ViIjoiNyIsInNjb3BlcyI6WyIqIl19.cDY5CiwW2AvngZdv3FvWP5pd9bm3gZ47fOh-EEtLKDpUBOxG8weKAVpPu6-gczudGHSrJpxdIipgbkNTGUOOMSMZNSQ493SoNi_HWFVpWjbHQIVYWHv5-zr-h8Q3zyKHsZkHf4isqt0d3t8DL3IsFgT-ZQ5bASNwbYWzYzL4foR_9mSQXErfmt6PVY0hFfaxLAvrXYg_zAksEDHSrhpBGP7KadrX9WQALXWpg4eyv1VlQcJp51H9AOMAM0UG-DYKDTms2ShzKWTb0CeJ8no4wpKNaTsMhHrFXZvhM8As1C4Wpl9tYhiLUYR7wVgSM4uyOns-6frZw2mA8HK_XKkSYZNznzOajNDj3fDEzPjxmlJS2MRTNUQDLAJEbqrzi-crM-h4PWlhApheR7EnM1zb8b0Ga1kwPi_IUmdCRL1_GNAktdusLamX9cz-Qx3aXelomqET9IvycTBZ_qmr_f_aWVkJzGUyFS4neQk7gK7MxiVixhi39EsnFBOlmR7vyPFrTpeZtgdye8UQmja6JirThEzc_6i0HJz78O4i9HXslbMzCakXN7P07Ts6VMX_YQD0ykLNtZZ71kUSrQ6M78alM110nEM2GwPUrHE2CXh9QgoyFQ8C1KCwGLFWsRR3_jJ_5wYoSiix83c-H9p90t2suwbEdLg7gl7q9JeY4rpTuHA {"open_type":1, "antilock_permission":1, "start_time":0, "end_time":0} |
2. 参数说明
Headers参数
| 字段 | 类型 | 是否必需 | 值 |
| Content-Type | String | 是 | application/json |
| Authorization | String | 是 | Bearer + 空格 + access_token值 |
Body参数
| 字段 | 类型 | 是否必需 | 描述 |
| masterId | String | Y | 宾客ID | 同一酒店下唯一; 第三方自己生成客人唯一标识，后面的续住、退房、换房等都使用这个masterId |
| bizType | String | Y | 业务点 | CHECKIN：入住，CHECKOUT：退房，MASTERCHG:续住，RMCHG:换房,GUESTCHG:客人档案修改（默认只在客人姓名、手机号、蓝牙授权修改时触发发送） |
| rmno | String | N | 楼号+楼层号+房间编号如010101 |
| BTAuth | Boolean | Y | 蓝牙开锁权限 | 默认不授权，蓝牙授权时手机号邮箱必填其一 |
| name | String | Y | 宾客姓名 |
| idNo | String | N | 证件号 | 默认身份证 |
| countryNo | String | Y | 国家代码 | 中国 +86 |
| mobile | String | N | 手机号 | 手机号跟邮箱至少需要一个 |
| email | String | N | 邮箱 | 手机号跟邮箱至少需要一个 |
| arr | String | Y | 抵店时间 | 格式yyyy-MM-dd HH:mm:ss |
| dep | String | Y | 离店时间 | 格式yyyy-MM-dd HH:mm:ss |
| orgRmno | String | N | 原房间 换房需要传 |
| realRate | String | N | 房价 |
3. 返回参数及示例
| 参数 | 类型 | 描述 |
| code | Int | |
| data | String | |
| message | String | |
| bin | String |
4. 接口示例
4.1“CHECKIN：入住”示例
4.2“CHECKOUT：退房”示例
4.3“MASTERCHG:续住”示例
如果有多人入住一间房间，只用操作其中一个人就行了，其他的会自动变动；
4.4“GUESTCHG:客人档案修改”示例
4.5“RMCHG:客人换房”示例
如果有多人入住一间房间，只用操作其中一个人就行了，其他的会自动变动；
