Guest Business Handling
https://api.orbitaiot.com/open/v1/hotelguest/guestCheckIn
1. HTTP Request Method and Example
| 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 cache-control: no-cache {"open_type":1, "antilock_permission":1, "start_time":0, "end_time":0} |
2. Parameter Description
Headers Parameter
| Key | Type | Request | Vlues |
| Content-Type | String | Y | application/json |
| Authorization | String | Y | Bearer [access_token value] |
Body Parameter
| Name | Type | Required | Description |
| masterId | String | Y | Guest ID | Unique within the same hotel Generated by the third party itself |
| bizType | String | Y | Business Type | CHECKIN: Check-in, CHECKOUT: Check-out, MASTERCHG: Extended stay, GUESTCHG: Guest profile modification (by default, only triggered and sent when modifying guest name, mobile phone number, or Bluetooth authorization) |
| rmno | String | N | Building + Floor + Room (each two digits, e.g., 010101) |
| BTAuth | Boolean | Y | Bluetooth Unlocking Permission | Not authorized by default. When authorizing Bluetooth, either mobile phone number or email must be filled in. |
| name | String | Y | Guest Name |
| idNo | String | N | ID Number | Default is ID card |
| countryNo | String | Y | Country Code | China +86 |
| mobile | String | N | Email | At least one of mobile phone number or email is required |
| email | String | N | Email | At least one of mobile phone number or email is required |
| arr | String | Y | Arrival Time | Format: yyyy - MM - dd HH:mm:ss |
| dep | String | Y | Departure Time | Format: yyyy - MM - dd HH:mm:ss |
| orgRmno | String | N | old rmno, RMCHG need |
| realRate | String | N | Room Rate |
3.Return Parameters and Examples
| Name | Type | Required |
| code | Int | |
| data | String | |
| message | String | |
| bin | String |
4.Interface Example
4.1“CHECKIN”Example

4.2“CHECKOUT”Example

4.3“MASTERCHG”Example

4.4“GUESTCHG”Example