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

KeyTypeRequestVlues
Content-Type
StringYapplication/json
Authorization
StringYBearer [access_token value]


Body Parameter

NameTypeRequiredDescription
masterId
String
YGuest ID | Unique within the same hotel Generated by the third party itself
bizType
String
YBusiness 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
NBuilding + Floor + Room (each two digits, e.g., 010101)
BTAuth
Boolean
YBluetooth Unlocking Permission | Not authorized by default. When authorizing Bluetooth, either mobile phone number or email must be filled in.
name
String
YGuest Name
idNo
String
NID Number | Default is ID card
countryNo
String
YCountry Code | China +86
mobile
String
NEmail | At least one of mobile phone number or email is required
email
StringNEmail | At least one of mobile phone number or email is required
arr
StringYArrival Time | Format: yyyy - MM - dd HH:mm:ss
dep
StringYDeparture Time | Format: yyyy - MM - dd HH:mm:ss
orgRmno
StringNold rmno, RMCHG need
realRateStringNRoom Rate

3.Return Parameters and Examples

Name
Type
Required
code
Int
data
String
message
String
binString




4.Interface Example

4.1“CHECKIN”Example


4.2“CHECKOUTExample

4.3“MASTERCHGExample


4.4“GUESTCHGExample