更新住客

更新某个入住单上一位住客的证件与个人信息,例如为当地住宿登记收集护照信息后回写。guest_id 即 查询订单 返回的 guests[].id。

修改保存在百居易的住客档案上,而不仅是这一张入住单:同一住客关联的其他入住单也会显示新值。未传的字段保持不变。本接口不支持清空字段,传 null 或空字符串会被拒绝。id_number 必须与 id_type 一起传。修改 name 后,后续渠道同步不再覆盖该住客的姓名,与在百居易网页端修改姓名一致。其他由渠道同步的字段只在为空时回填,不会覆盖这里写入的值。

入住单不存在,或住客不在该入住单上、属于其他账号时返回 404。

Path Params
string
required

住宿代码。

integer
required

住客 ID,即查询订单返回的 guests[].id。

Body Params

至少传一个字段。未传的字段保持不变;不接受 null 或空值。

string
enum

证件类型。传 id_number 时必填。gang_ao_tai_card(港澳台证件)与 serviceman_card(军人证)用于中国大陆证件;未列出的证件(如驾驶证)请用 others。

Allowed:
string
length ≤ 191

证件号码,最多 191 个字符。按传入值保存(去掉首尾空格)。

string
length ≤ 191

住客姓名,最多 191 个字符。

string
enum

住客性别,male 或 female。不传则保持不变;不能改回未知。

Allowed:
date

出生日期,格式 YYYY-MM-DD。须晚于 1900-01-01 且不晚于今天。查询订单与查询住客的 guests[].birthday 会按写入值返回。

string

国籍,ISO 3166-1 Alpha-2(例如 IT)。不区分大小写,按大写保存。

Response

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json