更新个人信息

更新员工的个人信息，包括姓名、个人电话、邮箱、联系地址、政治面貌、户口信息等

Tip: - 一般情况下如无特殊说明，对于非必填字段，不传值表示不做变更。
一般情况下如无特殊说明，对于多值分组字段，均为覆盖式更新，如更新 name_list 时，系统会按照所传数据保存，字段未传即为空值。
更新待入职的个人信息，应使用更新待入职接口。

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v2/persons/:person_id
HTTP Method	PATCH
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom
权限要求调用该 API 所需的权限。开启其中任意一项权限即可调用	`corehr:person:write` 读写员工的个人信息
字段权限要求	> Tip: 该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请 `corehr:person.address:read` 读取个人地址信息 `corehr:person.address:write` 读写个人地址信息 `corehr:person.bank_account:read` 获取银行账号列表信息 `corehr:person.bank_account:write` 读写银行账号信息 `corehr:person.born_country_region:read` 获取出生国家/地区信息 `corehr:person.custom_field:read` 获取个人信息自定义字段信息 `corehr:person.date_entered_workforce:read` 获取参加工作日期 `corehr:person.date_entered_workforce:write` 读写参加工作日期 `corehr:person.date_of_birth:read` 获取生日信息 `corehr:person.date_of_birth:write` 读写生日信息 `corehr:person.dependent:read` 获取家庭成员信息 `corehr:person.dependent:write` 读写家庭成员信息 `corehr:person.education:read` 获取教育经历信息 `corehr:person.education:write` 读写教育经历信息 `corehr:person.email:read` 获取个人邮箱信息 `corehr:person.email:write` 读写个人邮箱信息 `corehr:person.emergency_contact:read` 获取紧急联系人信息 `corehr:person.emergency_contact:write` 读写紧急联系人信息 `corehr:person.entry_leave_time:read` 获取出入境日期信息 `corehr:person.gender:read` 获取性别信息 `corehr:person.gender:write` 读写性别信息 `corehr:person.hukou:read` 获取户口信息 `corehr:person.hukou:write` 读写户口信息 `corehr:person.is_disabled:read` 获取残疾信息 `corehr:person.is_old_alone:read` 获取孤老信息 `corehr:person.legal_name:read` 获取法定姓名信息 `corehr:person.legal_name:write` 读写法定姓名信息 `corehr:person.marital_status:read` 获取婚姻状况信息 `corehr:person.marital_status:write` 读写婚姻状况信息 `corehr:person.martyr_family:read` 获取烈属信息 `corehr:person.martyr_family:write` 读写烈属信息 `corehr:person.national_id:read` 获取证件信息 `corehr:person.national_id:write` 读写证件信息 `corehr:person.native_region:read` 获取籍贯信息 `corehr:person.native_region:write` 读写籍贯信息 `corehr:person.personal_profile:read` 获取个人资料信息 `corehr:person.personal_profile:write` 读写个人资料信息 `corehr:person.phone:read` 获取个人手机号信息 `corehr:person.phone:write` 读写个人手机号信息 `corehr:person.race:read` 获取民族/种族信息 `corehr:person.resident_tax:read` 获取居民身份信息 `corehr:person.resident_tax:write` 读写居民身份信息 `corehr:person.resident_tax_custom_field:read` 获取居民身份自定义字段信息 `corehr:person.resident_tax_custom_field:write` 读写居民身份自定义字段信息 `corehr:person.work_experience:read` 获取工作履历信息 `corehr:person.work_experience:write` 读写工作履历信息 `corehr:person.born_country_region:write` 读写出生国家/地区信息 `corehr:person.is_disabled:write` 读写残疾信息 `corehr:person.entry_leave_time:write` 读写出入境日期信息 `corehr:person.is_old_alone:write` 读写孤老信息 `corehr:person.custom_field:write` 读写个人信息中的自定义字段信息

请求头

名称	类型	必填	描述
Authorization	string	是	`tenant_access_token` 值格式："Bearer `access_token`" 示例值："Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多：如何选择与获取 access token
Content-Type	string	是	固定值："application/json; charset=utf-8"

路径参数

名称	类型	描述
`person_id`	`string`	个人信息 ID - 该 ID 在【创建个人信息】时可从响应体中获取（person_id） - 此外你也可以调用【搜索员工信息】接口，获取指定员工的 person_id。示例值："12454646"

查询参数

名称	类型	必填	描述
`client_token`	`string`	否	操作的唯一标识，用于幂等的进行更新操作，格式为标准的 UUIDV4。此值为空表示将发起一次新的请求，此值非空表示幂等的进行更新操作。示例值："fe599b60-450f-46ff-b2ef-9f6675625b97"
`no_need_query`	`boolean`	否	根据no_need_query判断更新后是否返回更新后个人信息，若填写为 “true”则 data 为空。示例值：false

请求体

名称	类型	必填	描述
`name_list`	`person_name\[\]`	否	姓名列表 - 覆盖式更新
└ `local_primary`	`string`	否	姓 - 本地文字示例值："黄"
└ `local_first_name`	`string`	否	名 - 本地文字示例值："四"
└ `country_region_id`	`string`	是	国家/地区，可通过【查询国家/地区信息】获取示例值："6862995757234914824"
└ `name_type`	`enum`	是	姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：name_type
└ `enum_name`	`string`	是	枚举值示例值："legal_name"
└ `local_first_name_2`	`string`	否	名 - 第二本地文字示例值："五"
└ `local_primary_2`	`string`	否	姓 - 第二本地文字示例值："王"
└ `additional_name_type`	`enum`	否	补充姓名类型，可通过【获取字段详情】获取，查询参数： - custom_api_name：additional_name_type - object_api_name：person_name
└ `enum_name`	`string`	是	枚举值示例值："legal_name"
└ `first_name`	`string`	否	名示例值："帅"
└ `full_name`	`string`	否	全名示例值："王大帅"
└ `hereditary`	`string`	否	姓氏称谓示例值："王"
└ `custom_name`	`string`	否	自定义姓名（未传入时，姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）示例值："王大帅"
└ `custom_local_name`	`string`	否	本地文字的自定义姓名（未传入时，本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）示例值："王大帅"
└ `middle_name`	`string`	否	中间名示例值："大"
└ `name_primary`	`string`	否	姓示例值："王"
└ `secondary`	`string`	否	第二姓氏示例值："王"
└ `social`	`enum`	否	尊称，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name 示例值：王大帅
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `tertiary`	`string`	否	婚后姓氏示例值："王"
└ `title`	`enum`	否	头衔，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name 示例值：王
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `local_middle_name`	`string`	否	本地中间名示例值："大"
└ `local_secondary`	`string`	否	第二姓氏 - 本地文字示例值："王"
`gender`	`enum`	否	性别，枚举值可查询【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：gender - object_api_name：person
└ `enum_name`	`string`	是	枚举值示例值："male"
`date_of_birth`	`string`	否	出生日期示例值："2020-01-01"
`race`	`enum`	否	民族 / 种族，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：ethnicity_race - object_api_name：person
└ `enum_name`	`string`	是	枚举值示例值："example"
`marital_status`	`enum`	否	婚姻状况，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：marital_status - object_api_name：person
└ `enum_name`	`string`	是	枚举值示例值："example"
`phone_list`	`phone\[\]`	否	电话列表
└ `international_area_code`	`enum`	否	国家区号，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：international_area_code - object_api_name：phone
└ `enum_name`	`string`	是	枚举值示例值："86_china"
└ `phone_number`	`string`	是	电话号码示例值："010-12345678"
`address_list`	`address\[\]`	否	地址列表 - 覆盖式更新
└ `address_id`	`string`	否	地址 ID，在【创建个人信息】时返回的的地址ID；不可与其他地址使用相同 ID；为空时会返回新的ID 示例值："6989822217869624863"
└ `country_region_id`	`string`	是	国家/地区，可通过【查询国家/地区信息】获取示例值："6862995757234914824"
└ `region_id`	`string`	否	主要行政区，可通过【查询省份/主要行政区信息】获取示例值："6863326815667095047"
└ `address_line1`	`string`	否	地址行 1 示例值："丹佛测试地址-纽埃时区"
└ `address_line2`	`string`	否	地址行 2 示例值："PoewH"
└ `address_line3`	`string`	否	地址行 3 示例值："PoewH"
└ `address_line4`	`string`	否	地址行 4 示例值："jmwJc"
└ `address_line5`	`string`	否	地址行 5 示例值："jmwJc"
└ `address_line6`	`string`	否	地址行 6 示例值："jmwJc"
└ `address_line7`	`string`	否	地址行 7 示例值："jmwJc"
└ `address_line8`	`string`	否	地址行 8 示例值："rafSu"
└ `address_line9`	`string`	否	地址行 9 示例值："McPRG"
└ `local_address_line1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："丹佛测试地址-纽埃时区"
└ `local_address_line2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："PoewH"
└ `local_address_line3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："PoewH"
└ `local_address_line4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："rafSu"
└ `local_address_line9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："McPRG"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `address_type_list`	`enum\[\]`	是	地址类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：address - custom_api_name：address_type - 默认：home_address
└ `enum_name`	`string`	是	枚举值示例值："home_address"
└ `is_primary`	`boolean`	是	主要地址默认：true 示例值：true
└ `is_public`	`boolean`	是	公开地址默认：false 示例值：true
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 具体支持的对象请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
`email_list`	`email\[\]`	否	邮箱列表
└ `email`	`string`	是	邮箱地址 - 覆盖式更新示例值："1234567@example.feishu.cn"
└ `is_primary`	`boolean`	否	是否为主要邮箱默认：true 示例值：true
└ `is_public`	`boolean`	否	是否为公开邮箱默认：true 示例值：true
└ `email_usage`	`enum`	否	邮箱用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: email - custom_api_name：email_usage - 请勿填写 work 枚举，工作邮箱在雇佣信息中操作 - 默认：emergency_contact
└ `enum_name`	`string`	是	枚举值示例值："emergency_contact"
`work_experience_list`	`work_experience_info\[\]`	否	工作经历列表 - 覆盖式更新
└ `company_organization`	`i18n\[\]`	否	公司 / 组织
└ `lang`	`string`	是	语言编码（IETF BCP 47）示例值："zh-CN"
└ `value`	`string`	是	文本内容示例值："中文示例"
└ `department`	`i18n\[\]`	否	部门
└ `lang`	`string`	是	语言编码（IETF BCP 47）示例值："zh-CN"
└ `value`	`string`	是	文本内容示例值："中文示例"
└ `job`	`i18n\[\]`	否	岗位
└ `lang`	`string`	是	语言编码（IETF BCP 47）示例值："zh-CN"
└ `value`	`string`	是	文本内容示例值："中文示例"
└ `description`	`i18n\[\]`	否	工作描述
└ `lang`	`string`	是	语言编码（IETF BCP 47）示例值："zh-CN"
└ `value`	`string`	是	文本内容示例值："中文示例"
└ `start_date`	`string`	否	开始日期示例值："2020-01-01"
└ `end_date`	`string`	否	结束日期示例值："2020-01-01"
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
`education_list`	`education\[\]`	否	教育经历列表 - 覆盖式更新
└ `school`	`i18n\[\]`	是	学校 - 如果学校有对应枚举，请使用 school_name 字段
└ `lang`	`string`	是	语言编码（IETF BCP 47）示例值："zh-CN"
└ `value`	`string`	是	文本内容示例值："中文示例"
└ `level_of_education`	`enum`	否	学历 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：level_of_education
└ `enum_name`	`string`	是	枚举值示例值："phd"
└ `start_date`	`string`	否	开始日期示例值："2011-09-01"
└ `end_date`	`string`	否	结束日期示例值："2015-06-30"
└ `field_of_study`	`i18n\[\]`	否	专业 - 如果专业有对应枚举，请使用 field_of_study_name 字段
└ `lang`	`string`	是	语言编码（IETF BCP 47）示例值："zh-CN"
└ `value`	`string`	是	文本内容示例值："中文示例"
└ `degree`	`enum`	否	学位 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：degree
└ `enum_name`	`string`	是	枚举值示例值："mba"
└ `school_name`	`enum`	否	学校名称 - 可通过【获取字段详情】获取，查询参数： - custom_api_name：school_name - object_api_name：education - 如果学校有对应枚举，请使用该字段，否则可使用 school 直接写入文本
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `field_of_study_name`	`enum`	否	专业名称 - 可通过【获取字段详情】获取，查询参数： - custom_api_name：field_of_study_name - object_api_name：education - 如果专业有对应枚举，请使用该字段，否则可使用 field_of_study 直接写入文本
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `country_region_id`	`string`	否	国家地区ID，可通过【查询国家/地区信息】获取示例值："1"
└ `expected_end_date`	`string`	否	预期结束日期示例值："2011-09-01"
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
`bank_account_list`	`bank_account\[\]`	否	银行账户 - 覆盖式更新
└ `bank_name`	`string`	否	银行名称 - 如果有对应银行ID，请使用 bank_id_v2 示例值："中国农业银行"
└ `bank_account_number`	`string`	是	银行账号示例值："6231200000001223"
└ `account_holder`	`string`	是	开户人姓名示例值："孟十五"
└ `branch_name`	`string`	否	支行名称 - 如果有对应支行 ID，请使用 branch_id_v2 示例值："中国农业银行支行"
└ `bank_id_v2`	`string`	否	银行 ID，详细信息可通过【查询银行信息】接口查询获得示例值："MDBH00000001"
└ `branch_id_v2`	`string`	否	支行 ID，要求必须为填入银行的支行，详细信息可通过【查询支行信息】接口查询获得示例值："MDBK00000017"
└ `country_region_id`	`string`	否	国家/地区 ID，详细信息可通过【查询国家/地区信息】接口查询获得示例值："12"
└ `bank_account_usage`	`enum\[\]`	否	银行卡用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: bank_account - custom_api_name: bank_account_usage
└ `enum_name`	`string`	是	枚举值示例值："payment"
└ `bank_account_type`	`enum`	否	银行卡类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: bank_account - custom_api_name: bank_account_type
└ `enum_name`	`string`	是	枚举值示例值："checking"
└ `currency_id`	`string`	否	货币 ID - 详细信息可通过【查询货币信息】接口查询获得示例值："12QueryCountryRegionSubdivisionDataReq"
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 具体支持的对象请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
`national_id_list`	`national_id\[\]`	否	证件 - 覆盖式更新
└ `national_id_type_id`	`string`	是	国家证件类型，可通过【批量查询国家证件类型】获得示例值："6863330041896371725"
└ `national_id_number`	`string`	是	证件号码示例值："1231131333"
└ `issue_date`	`string`	否	证件签发日期示例值："2020-04-01"
└ `expiration_date`	`string`	否	证件到期日期示例值："2020-05-21"
└ `country_region_id`	`string`	是	国家/地区，可通过【查询国家/地区信息】获取示例值："6862995757234914824"
└ `issued_by`	`string`	否	证件签发机构示例值："北京市公安局"
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 具体支持的对象请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
`dependent_list`	`dependent\[\]`	否	家庭成员列表 - 覆盖式更新
└ `relationship`	`enum`	是	关系 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：dependent - custom_api_name：relationship_with_dependent
└ `enum_name`	`string`	是	枚举值示例值："parent"
└ `gender`	`enum`	否	性别，枚举值可查询【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：gender - object_api_name：person
└ `enum_name`	`string`	是	枚举值示例值："male"
└ `date_of_birth`	`string`	否	生日示例值："2020-01-01"
└ `nationality_id_v2`	`string`	否	国籍 ID，可通过【查询国籍信息】获取示例值："6862995745046267401"
└ `national_id_list`	`national_id\[\]`	否	证件号码
└ `national_id_type_id`	`string`	是	国家证件类型，可通过【批量查询国家证件类型】获得示例值："6863330041896371725"
└ `national_id_number`	`string`	是	证件号码示例值："1231131333"
└ `issue_date`	`string`	否	证件签发日期示例值："2020-04-01"
└ `expiration_date`	`string`	否	证件到期日期示例值："2020-05-21"
└ `country_region_id`	`string`	是	国家/地区ID，可通过【查询国家/地区信息】获取示例值："6862995757234914824"
└ `issued_by`	`string`	否	证件签发机构示例值："北京市公安局"
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
└ `spouses_working_status`	`enum`	否	配偶工作状态，可通过【获取字段详情】获取，查询参数： - custom_api_name：spouses_working_status - object_api_name：dependent
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `is_this_person_covered_by_health_insurance`	`boolean`	否	包含家属医疗保险示例值：true
└ `is_this_person_allowed_for_tax_deduction`	`boolean`	否	允许家属抵扣税款示例值：false
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
└ `dependent_name`	`string`	否	家庭成员姓名示例值："张三"
└ `employer`	`string`	否	工作单位示例值："海淀区交警大队"
└ `job`	`string`	否	岗位示例值："保安"
└ `phone`	`phone`	否	电话
└ `international_area_code`	`enum`	否	国家区号，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：international_area_code - object_api_name：phone
└ `enum_name`	`string`	是	枚举值示例值："86_china"
└ `phone_number`	`string`	是	电话号码示例值："010-12345678"
└ `address`	`address`	否	联系地址
└ `address_id`	`string`	否	地址 ID，在【创建个人信息】时返回的的地址ID；不可与其他地址使用相同 ID；为空时返回新的ID 示例值："6989822217869624863"
└ `country_region_id`	`string`	是	国家/地区，可通过【查询国家/地区信息】获取示例值："6862995757234914824"
└ `region_id`	`string`	否	主要行政区，可通过【查询省份/主要行政区信息】获取示例值："6863326815667095047"
└ `address_line1`	`string`	否	地址行 1 示例值："丹佛测试地址-纽埃时区"
└ `address_line2`	`string`	否	地址行 2 示例值："PoewH"
└ `address_line3`	`string`	否	地址行 3 示例值："PoewH"
└ `address_line4`	`string`	否	地址行 4 示例值："jmwJc"
└ `address_line5`	`string`	否	地址行 5 示例值："jmwJc"
└ `address_line6`	`string`	否	地址行 6 示例值："jmwJc"
└ `address_line7`	`string`	否	地址行 7 示例值："jmwJc"
└ `address_line8`	`string`	否	地址行 8 示例值："rafSu"
└ `address_line9`	`string`	否	地址行 9 示例值："McPRG"
└ `local_address_line1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："丹佛测试地址-纽埃时区"
└ `local_address_line2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："PoewH"
└ `local_address_line3`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："PoewH"
└ `local_address_line4`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line5`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line6`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line7`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line8`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："rafSu"
└ `local_address_line9`	`string`	否	地址行 9（非拉丁语系的本地文字）示例值："McPRG"
└ `postal_code`	`string`	否	邮政编码示例值："611530"
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
└ `birth_certificate_of_child`	`file\[\]`	否	出生证明
└ `id`	`string`	否	文件ID，可通过【上传文件】获取示例值："150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
`emergency_contact_list`	`emergency_contact\[\]`	否	紧急联系人列表 - 覆盖式更新
└ `name`	`person_name`	否	姓名 - 该字段已弃用，请使用 legal_name
└ `local_primary`	`string`	否	姓 - 本地文字示例值："黄"
└ `local_first_name`	`string`	否	名 - 本地文字示例值："四"
└ `country_region_id`	`string`	是	国家/地区ID，可通过【查询国家/地区信息】获取示例值："6862995757234914824"
└ `name_type`	`enum`	是	姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：name_type
└ `enum_name`	`string`	是	枚举值示例值："legal_name"
└ `local_first_name_2`	`string`	否	名 - 第二本地文字示例值："五"
└ `local_primary_2`	`string`	否	姓 - 第二本地文字示例值："王"
└ `additional_name_type`	`enum`	否	补充姓名类型，可通过【获取字段详情】获取，查询参数： - custom_api_name：additional_name_type - object_api_name：person_name
└ `enum_name`	`string`	是	枚举值示例值："legal_name"
└ `first_name`	`string`	否	名示例值："帅"
└ `full_name`	`string`	否	全名示例值："王大帅"
└ `hereditary`	`string`	否	姓氏称谓示例值："王"
└ `custom_name`	`string`	否	自定义姓名（未传入时，姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）示例值："王大帅"
└ `custom_local_name`	`string`	否	本地文字的自定义姓名（未传入时，本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）示例值："王大帅"
└ `middle_name`	`string`	否	中间名示例值："大"
└ `name_primary`	`string`	否	姓示例值："王"
└ `secondary`	`string`	否	第二姓氏示例值："王"
└ `social`	`enum`	否	尊称，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name 示例值：王大帅
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `tertiary`	`string`	否	婚后姓氏示例值："王"
└ `title`	`enum`	否	头衔，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name 示例值：王
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `local_middle_name`	`string`	否	本地中间名示例值："大"
└ `local_secondary`	`string`	否	第二姓氏 - 本地文字示例值："王"
└ `relationship`	`enum`	否	关系 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：dependent - custom_api_name：relationship_with_dependent
└ `enum_name`	`string`	是	枚举值示例值："parent"
└ `phone_ist`	`phone\[\]`	否	电话
└ `international_area_code`	`enum`	否	国家区号，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：international_area_code - object_api_name：phone
└ `enum_name`	`string`	是	枚举值示例值："86_china"
└ `phone_number`	`string`	是	电话号码示例值："010-12345678"
└ `legal_name`	`string`	否	法定姓名示例值："张三"
└ `custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
`date_entered_workforce`	`string`	否	参加工作日期示例值："2020-10-01"
`profile_image_id`	`string`	否	头像资源的 ID - 该字段已废弃示例值："dfysuc8x76dsfsw"
`personal_profile`	`personal_profile\[\]`	否	个人资料附件，该字段为全量覆盖式更新，请谨慎操作
└ `personal_profile_type`	`enum`	否	资料类型 - 可通过【获取字段详情】获取，查询参数： - custom_api_name：profile_type - object_api_name：personal_profile - 仅【飞书人事-档案配置-资料附件】存在的字段编码可用
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `files`	`file\[\]`	否	上传文件列表
└ `id`	`string`	否	文件ID，可通过【上传文件】获取示例值："150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
`native_region`	`string`	否	籍贯 ID，可通过【查询省份/主要行政区信息】获取示例值："6863326262618752111"
`hukou_type`	`enum`	否	户口类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: person_info_chn - custom_api_name: hukou_type
└ `enum_name`	`string`	是	枚举值示例值："local_urban_residence"
`hukou_location`	`string`	否	户口所在地示例值："山东省平阴县"
`political_affiliations`	`enum\[\]`	否	政治面貌 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_info_chn - custom_api_name：political_affiliation
└ `enum_name`	`string`	是	枚举值示例值："communist_party_of_china"
`talent_id`	`string`	否	人才ID，可通过【获取人才列表】获取示例值："6863326262618752123"
`custom_fields`	`custom_field_data\[\]`	否	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	是	自定义字段 apiname，即自定义字段的唯一标识示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值：""231""
`born_country_region`	`string`	否	出生国家 / 地区 ID - 可通过【查询国家/地区信息】接口获取示例值："中国"
`is_disabled`	`boolean`	否	是否残疾示例值：true
`disable_card_number`	`string`	否	残疾证号示例值："1110000"
`is_martyr_family`	`boolean`	否	是否烈属示例值：true
`martyr_card_number`	`string`	否	烈属证号示例值："1110000"
`is_old_alone`	`boolean`	否	是否孤老示例值：true
`resident_taxes`	`resident_tax\[\]`	否	居民身份信息 - 覆盖式更新示例值：6863326262618752123
└ `year_resident_tax`	`string`	是	年度示例值："2023"
└ `resident_status`	`enum`	否	居民身份，可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：resident_tax - custom_api_name：resident_status
└ `enum_name`	`string`	是	枚举值示例值："example"
└ `tax_country_region_id`	`string`	否	国家/地区，可通过【查询国家/地区信息】获取示例值："中国"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段 - 请参考【自定义字段说明】
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段示例值："Sandy"
`first_entry_time`	`string`	否	首次入境日期示例值："2021-01-02"
`leave_time`	`string`	否	预计离境日期示例值："2022-01-02"

请求体示例

json

{
    "name_list": [
        {
            "local_primary": "黄",
            "local_first_name": "四",
            "country_region_id": "6862995757234914824",
            "name_type": {
                "enum_name": "legal_name"
            },
            "local_first_name_2": "五",
            "local_primary_2": "王",
            "additional_name_type": {
                "enum_name": "legal_name"
            },
            "first_name": "帅",
            "full_name": "王大帅",
            "hereditary": "王",
            "custom_name": "王大帅",
            "custom_local_name": "王大帅",
            "middle_name": "大",
            "name_primary": "王",
            "secondary": "王",
            "social": {
                "enum_name": "example"
            },
            "tertiary": "王",
            "title": {
                "enum_name": "example"
            },
            "local_middle_name": "大",
            "local_secondary": "王"
        }
    ],
    "gender": {
        "enum_name": "male"
    },
    "date_of_birth": "2020-01-01",
    "race": {
        "enum_name": "example"
    },
    "marital_status": {
        "enum_name": "example"
    },
    "phone_list": [
        {
            "international_area_code": {
                "enum_name": "86_china"
            },
            "phone_number": "010-12345678"
        }
    ],
    "address_list": [
        {
            "address_id": "6989822217869624863",
            "country_region_id": "6862995757234914824",
            "region_id": "6863326815667095047",
            "address_line1": "丹佛测试地址-纽埃时区",
            "address_line2": "PoewH",
            "address_line3": "PoewH",
            "address_line4": "jmwJc",
            "address_line5": "jmwJc",
            "address_line6": "jmwJc",
            "address_line7": "jmwJc",
            "address_line8": "rafSu",
            "address_line9": "McPRG",
            "local_address_line1": "丹佛测试地址-纽埃时区",
            "local_address_line2": "PoewH",
            "local_address_line3": "PoewH",
            "local_address_line4": "jmwJc",
            "local_address_line5": "jmwJc",
            "local_address_line6": "jmwJc",
            "local_address_line7": "jmwJc",
            "local_address_line8": "rafSu",
            "local_address_line9": "McPRG",
            "postal_code": "611530",
            "address_type_list": [
                {
                    "enum_name": "home_address"
                }
            ],
            "is_primary": true,
            "is_public": true,
            "custom_fields": [
                {
                    "custom_api_name": "name",
                    "value": "\"231\""
                }
            ]
        }
    ],
    "email_list": [
        {
            "email": "1234567@example.feishu.cn",
            "is_primary": true,
            "is_public": true,
            "email_usage": {
                "enum_name": "emergency_contact"
            }
        }
    ],
    "work_experience_list": [
        {
            "company_organization": [
                {
                    "lang": "zh-CN",
                    "value": "中文示例"
                }
            ],
            "department": [
                {
                    "lang": "zh-CN",
                    "value": "中文示例"
                }
            ],
            "job": [
                {
                    "lang": "zh-CN",
                    "value": "中文示例"
                }
            ],
            "description": [
                {
                    "lang": "zh-CN",
                    "value": "中文示例"
                }
            ],
            "start_date": "2020-01-01",
            "end_date": "2020-01-01",
            "custom_fields": [
                {
                    "custom_api_name": "name",
                    "value": "\"231\""
                }
            ]
        }
    ],
    "education_list": [
        {
            "school": [
                {
                    "lang": "zh-CN",
                    "value": "中文示例"
                }
            ],
            "level_of_education": {
                "enum_name": "phd"
            },
            "start_date": "2011-09-01",
            "end_date": "2015-06-30",
            "field_of_study": [
                {
                    "lang": "zh-CN",
                    "value": "中文示例"
                }
            ],
            "degree": {
                "enum_name": "mba"
            },
            "school_name": {
                "enum_name": "example"
            },
            "field_of_study_name": {
                "enum_name": "example"
            },
            "country_region_id": "1",
            "expected_end_date": "2011-09-01",
            "custom_fields": [
                {
                    "custom_api_name": "name",
                    "value": "\"231\""
                }
            ]
        }
    ],
    "bank_account_list": [
        {
            "bank_name": "中国农业银行",
            "bank_account_number": "6231200000001223",
            "account_holder": "孟十五",
            "branch_name": "中国农业银行支行",
            "bank_id_v2": "MDBH00000001",
            "branch_id_v2": "MDBK00000017",
            "country_region_id": "12",
            "bank_account_usage": [
                {
                    "enum_name": "payment"
                }
            ],
            "bank_account_type": {
                "enum_name": "checking"
            },
            "currency_id": "12QueryCountryRegionSubdivisionDataReq",
            "custom_fields": [
                {
                    "custom_api_name": "name",
                    "value": "\"231\""
                }
            ]
        }
    ],
    "national_id_list": [
        {
            "national_id_type_id": "6863330041896371725",
            "national_id_number": "1231131333",
            "issue_date": "2020-04-01",
            "expiration_date": "2020-05-21",
            "country_region_id": "6862995757234914824",
            "issued_by": "北京市公安局",
            "custom_fields": [
                {
                    "custom_api_name": "name",
                    "value": "\"231\""
                }
            ]
        }
    ],
    "dependent_list": [
        {
            "relationship": {
                "enum_name": "parent"
            },
            "gender": {
                "enum_name": "male"
            },
            "date_of_birth": "2020-01-01",
            "nationality_id_v2": "6862995745046267401",
            "national_id_list": [
                {
                    "national_id_type_id": "6863330041896371725",
                    "national_id_number": "1231131333",
                    "issue_date": "2020-04-01",
                    "expiration_date": "2020-05-21",
                    "country_region_id": "6862995757234914824",
                    "issued_by": "北京市公安局",
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "value": "\"231\""
                        }
                    ]
                }
            ],
            "spouses_working_status": {
                "enum_name": "example"
            },
            "is_this_person_covered_by_health_insurance": true,
            "is_this_person_allowed_for_tax_deduction": false,
            "custom_fields": [
                {
                    "custom_api_name": "name",
                    "value": "\"231\""
                }
            ],
            "dependent_name": "张三",
            "employer": "海淀区交警大队",
            "job": "保安",
            "phone": {
                "international_area_code": {
                    "enum_name": "86_china"
                },
                "phone_number": "010-12345678"
            },
            "address": {
                "address_id": "6989822217869624863",
                "country_region_id": "6862995757234914824",
                "region_id": "6863326815667095047",
                "address_line1": "丹佛测试地址-纽埃时区",
                "address_line2": "PoewH",
                "address_line3": "PoewH",
                "address_line4": "jmwJc",
                "address_line5": "jmwJc",
                "address_line6": "jmwJc",
                "address_line7": "jmwJc",
                "address_line8": "rafSu",
                "address_line9": "McPRG",
                "local_address_line1": "丹佛测试地址-纽埃时区",
                "local_address_line2": "PoewH",
                "local_address_line3": "PoewH",
                "local_address_line4": "jmwJc",
                "local_address_line5": "jmwJc",
                "local_address_line6": "jmwJc",
                "local_address_line7": "jmwJc",
                "local_address_line8": "rafSu",
                "local_address_line9": "McPRG",
                "postal_code": "611530",
                "custom_fields": [
                    {
                        "custom_api_name": "name",
                        "value": "\"231\""
                    }
                ]
            },
            "birth_certificate_of_child": [
                {
                    "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
                }
            ]
        }
    ],
    "emergency_contact_list": [
        {
            "name": {
                "local_primary": "黄",
                "local_first_name": "四",
                "country_region_id": "6862995757234914824",
                "name_type": {
                    "enum_name": "legal_name"
                },
                "local_first_name_2": "五",
                "local_primary_2": "王",
                "additional_name_type": {
                    "enum_name": "legal_name"
                },
                "first_name": "帅",
                "full_name": "王大帅",
                "hereditary": "王",
                "custom_name": "王大帅",
                "custom_local_name": "王大帅",
                "middle_name": "大",
                "name_primary": "王",
                "secondary": "王",
                "social": {
                    "enum_name": "example"
                },
                "tertiary": "王",
                "title": {
                    "enum_name": "example"
                },
                "local_middle_name": "大",
                "local_secondary": "王"
            },
            "relationship": {
                "enum_name": "parent"
            },
            "phone_ist": [
                {
                    "international_area_code": {
                        "enum_name": "86_china"
                    },
                    "phone_number": "010-12345678"
                }
            ],
            "legal_name": "张三",
            "custom_fields": [
                {
                    "custom_api_name": "name",
                    "value": "\"231\""
                }
            ]
        }
    ],
    "date_entered_workforce": "2020-10-01",
    "profile_image_id": "dfysuc8x76dsfsw",
    "personal_profile": [
        {
            "personal_profile_type": {
                "enum_name": "example"
            },
            "files": [
                {
                    "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
                }
            ]
        }
    ],
    "native_region": "6863326262618752111",
    "hukou_type": {
        "enum_name": "local_urban_residence"
    },
    "hukou_location": "山东省平阴县",
    "political_affiliations": [
        {
            "enum_name": "communist_party_of_china"
        }
    ],
    "talent_id": "6863326262618752123",
    "custom_fields": [
        {
            "custom_api_name": "name",
            "value": "\"231\""
        }
    ],
    "born_country_region": "中国",
    "is_disabled": true,
    "disable_card_number": "1110000",
    "is_martyr_family": true,
    "martyr_card_number": "1110000",
    "is_old_alone": true,
    "resident_taxes": [
        {
            "year_resident_tax": "2023",
            "resident_status": {
                "enum_name": "example"
            },
            "tax_country_region_id": "中国",
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "Sandy"
                }
            ]
        }
    ],
    "first_entry_time": "2021-01-02",
    "leave_time": "2022-01-02"
}

响应

响应体

名称	类型	描述
`code`	`int`	错误码，非 0 表示失败
`msg`	`string`	错误描述
`data`	`\-`	-
└ `person`	`person_info`	个人信息
└ `person_id`	`string`	个人信息 ID
└ `phone_number`	`string`	个人电话字段权限要求（满足任一）： `corehr:person.phone:read` 获取个人手机号信息 `corehr:person.phone:write` 读写个人手机号信息
└ `legal_name`	`string`	法定姓名字段权限要求（满足任一）： `corehr:person.legal_name:read` 获取法定姓名信息 `corehr:person.legal_name:write` 读写法定姓名信息
└ `preferred_name`	`string`	常用名
└ `preferred_local_full_name`	`string`	常用本地全名
└ `preferred_english_full_name`	`string`	常用英文全名
└ `name_list`	`person_name\[\]`	姓名列表字段权限要求（满足任一）： `corehr:person.legal_name:read` 获取法定姓名信息 `corehr:person.legal_name:write` 读写法定姓名信息
└ `local_primary`	`string`	姓 - 本地文字
└ `local_first_name`	`string`	名 - 本地文字
└ `country_region_id`	`string`	国家/地区，可通过【查询国家/地区信息】获取
└ `name_type`	`enum`	姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：name_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `local_first_name_2`	`string`	名 - 第二本地文字
└ `local_primary_2`	`string`	姓 - 第二本地文字
└ `additional_name_type`	`enum`	补充姓名类型，可通过【获取字段详情】获取，查询参数： - custom_api_name：additional_name_type - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `first_name`	`string`	名
└ `full_name`	`string`	全名
└ `hereditary`	`string`	姓氏称谓
└ `custom_name`	`string`	自定义姓名（未传入时，姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）
└ `custom_local_name`	`string`	本地文字的自定义姓名（未传入时，本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）
└ `middle_name`	`string`	中间名
└ `name_primary`	`string`	姓
└ `secondary`	`string`	第二姓氏
└ `social`	`enum`	尊称，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `tertiary`	`string`	婚后姓氏
└ `title`	`enum`	头衔，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `local_middle_name`	`string`	本地中间名
└ `local_secondary`	`string`	第二姓氏 - 本地文字
└ `display_name_local_and_western_script`	`string`	展示姓名（本地和西方文字）
└ `display_name_local_script`	`string`	展示姓名（本地文字）
└ `display_name_western_script`	`string`	展示姓名（西方文字）
└ `gender`	`enum`	性别，枚举值可查询【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：gender - object_api_name：person 字段权限要求（满足任一）： `corehr:person.gender:read` 获取性别信息 `corehr:person.gender:write` 读写性别信息
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `date_of_birth`	`string`	出生日期字段权限要求（满足任一）： `corehr:person.date_of_birth:read` 获取生日信息 `corehr:person.date_of_birth:write` 读写生日信息
└ `race`	`enum`	民族 / 种族，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：ethnicity_race - object_api_name：person 字段权限要求： `corehr:person.race:read` 获取民族/种族信息
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `marital_status`	`enum`	婚姻状况，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：marital_status - object_api_name：person 字段权限要求（满足任一）： `corehr:person.marital_status:read` 获取婚姻状况信息 `corehr:person.marital_status:write` 读写婚姻状况信息
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_list`	`phone\[\]`	电话列表字段权限要求（满足任一）： `corehr:person.phone:read` 获取个人手机号信息 `corehr:person.phone:write` 读写个人手机号信息
└ `international_area_code`	`enum`	国家区号，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：international_area_code - object_api_name：phone
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_number`	`string`	电话号码
└ `formatted_phone_number`	`string`	完整电话号码
└ `device_type`	`enum`	设备类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：device_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_usage`	`enum`	电话用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：phone_usage
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `is_primary`	`boolean`	主要电话
└ `is_public`	`boolean`	公开电话
└ `address_list`	`address\[\]`	地址列表字段权限要求（满足任一）： `corehr:person.address:read` 读取个人地址信息 `corehr:person.address:write` 读写个人地址信息
└ `full_address_local_script`	`string`	完整地址（本地文字）
└ `full_address_western_script`	`string`	完整地址（西方文字）
└ `address_id`	`string`	地址 ID，在请求体值为空时生成新值，请注意保存
└ `country_region_id`	`string`	国家/地区ID，可通过【查询国家/地区信息】获取
└ `region_id`	`string`	主要行政区，可通过【查询省份/主要行政区信息】获取
└ `address_line1`	`string`	地址行 1
└ `address_line2`	`string`	地址行 2
└ `address_line3`	`string`	地址行 3
└ `address_line4`	`string`	地址行 4
└ `address_line5`	`string`	地址行 5
└ `address_line6`	`string`	地址行 6
└ `address_line7`	`string`	地址行 7
└ `address_line8`	`string`	地址行 8
└ `address_line9`	`string`	地址行 9
└ `local_address_line1`	`string`	地址行 1（非拉丁语系的本地文字）
└ `local_address_line2`	`string`	地址行 2（非拉丁语系的本地文字）
└ `local_address_line3`	`string`	地址行 3（非拉丁语系的本地文字）
└ `local_address_line4`	`string`	地址行 4（非拉丁语系的本地文字）
└ `local_address_line5`	`string`	地址行 5（非拉丁语系的本地文字）
└ `local_address_line6`	`string`	地址行 6（非拉丁语系的本地文字）
└ `local_address_line7`	`string`	地址行 7（非拉丁语系的本地文字）
└ `local_address_line8`	`string`	地址行 8（非拉丁语系的本地文字）
└ `local_address_line9`	`string`	地址行 9（非拉丁语系的本地文字）
└ `postal_code`	`string`	邮政编码
└ `address_type_list`	`enum\[\]`	地址类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：address - custom_api_name：address_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `is_primary`	`boolean`	主要地址
└ `is_public`	`boolean`	公开地址
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `email_list`	`email\[\]`	邮箱列表字段权限要求（满足任一）： `corehr:person.email:read` 获取个人邮箱信息 `corehr:person.email:write` 读写个人邮箱信息
└ `email`	`string`	邮箱地址
└ `is_primary`	`boolean`	是否为主要邮箱
└ `is_public`	`boolean`	是否为公开邮箱
└ `email_usage`	`enum`	邮箱用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: email - custom_api_name：email_usage
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `work_experience_list`	`work_experience_info\[\]`	工作经历列表字段权限要求（满足任一）： `corehr:person.work_experience:read` 获取工作履历信息 `corehr:person.work_experience:write` 读写工作履历信息
└ `company_organization`	`i18n\[\]`	公司 / 组织
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `department`	`i18n\[\]`	部门
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `job`	`i18n\[\]`	岗位
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `description`	`i18n\[\]`	工作描述
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `start_date`	`string`	开始日期
└ `end_date`	`string`	结束日期
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `education_list`	`education\[\]`	教育经历列表字段权限要求（满足任一）： `corehr:person.education:read` 获取教育经历信息 `corehr:person.education:write` 读写教育经历信息
└ `school`	`i18n\[\]`	学校 - 如果学校有对应枚举，请使用 school_name
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `level_of_education`	`enum`	学历 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：level_of_education
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `start_date`	`string`	开始日期
└ `end_date`	`string`	结束日期
└ `field_of_study`	`i18n\[\]`	专业
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `degree`	`enum`	学位 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：degree
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `school_name`	`enum`	学校名称 - 枚举值可通过【获取字段详情】获取，查询参数： - custom_api_name：school_name - object_api_name：education - 如果学校有对应枚举，请使用该字段，否则可使用 school 直接写入文本
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `field_of_study_name`	`enum`	专业名称，可通过【获取字段详情】获取，查询参数： - custom_api_name：field_of_study_name - object_api_name：education
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `country_region_id`	`string`	国家地区 ID，可通过【查询国家/地区信息】接口获得
└ `expected_end_date`	`string`	预期结束日期
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `bank_account_list`	`bank_account\[\]`	银行账户字段权限要求（满足任一）： `corehr:person.bank_account:read` 获取银行账号列表信息 `corehr:person.bank_account:write` 读写银行账号信息
└ `bank_name`	`string`	银行名称
└ `bank_account_number`	`string`	银行账号
└ `account_holder`	`string`	开户人姓名
└ `branch_name`	`string`	支行名称
└ `bank_id_v2`	`string`	银行 ID，详细信息可通过【查询银行信息】接口查询获得
└ `branch_id_v2`	`string`	支行 ID，要求必须为填入银行的支行，详细信息可通过【查询支行信息】接口查询获得
└ `country_region_id`	`string`	国家/地区 ID，详细信息可通过【查询国家/地区信息】接口查询获得
└ `bank_account_usage`	`enum\[\]`	银行卡用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: bank_account - custom_api_name: bank_account_usage
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `bank_account_type`	`enum`	银行卡类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: bank_account - custom_api_name: bank_account_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `currency_id`	`string`	货币 ID，可通过【查询货币信息】接口查询获得
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `national_id_list`	`national_id\[\]`	证件字段权限要求（满足任一）： `corehr:person.national_id:read` 获取证件信息 `corehr:person.national_id:write` 读写证件信息
└ `national_id_type_id`	`string`	国家证件类型，可通过【批量查询国家证件类型】接口获取
└ `national_id_number`	`string`	证件号码
└ `issue_date`	`string`	证件签发日期
└ `expiration_date`	`string`	证件到期日期
└ `country_region_id`	`string`	国家/地区ID，可通过【查询国家/地区信息】获取
└ `issued_by`	`string`	证件签发机构
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `dependent_list`	`dependent\[\]`	家庭成员列表字段权限要求（满足任一）： `corehr:person.dependent:read` 获取家庭成员信息 `corehr:person.dependent:write` 读写家庭成员信息
└ `name`	`person_name`	姓名
└ `local_primary`	`string`	姓 - 本地文字
└ `local_first_name`	`string`	名 - 本地文字
└ `country_region_id`	`string`	国家/地区ID，可通过【查询国家/地区信息】获取
└ `name_type`	`enum`	姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：name_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `local_first_name_2`	`string`	名 - 第二本地文字
└ `local_primary_2`	`string`	姓 - 第二本地文字
└ `additional_name_type`	`enum`	补充姓名类型，可通过【获取字段详情】获取，查询参数： - custom_api_name：additional_name_type - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `first_name`	`string`	名
└ `full_name`	`string`	全名
└ `hereditary`	`string`	姓氏称谓
└ `custom_name`	`string`	自定义姓名（未传入时，姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）
└ `custom_local_name`	`string`	本地文字的自定义姓名（未传入时，本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）
└ `middle_name`	`string`	中间名
└ `name_primary`	`string`	姓
└ `secondary`	`string`	第二姓氏
└ `social`	`enum`	尊称，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `tertiary`	`string`	婚后姓氏
└ `title`	`enum`	头衔，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `local_middle_name`	`string`	本地中间名
└ `local_secondary`	`string`	第二姓氏 - 本地文字
└ `display_name_local_and_western_script`	`string`	展示姓名（本地和西方文字）
└ `display_name_local_script`	`string`	展示姓名（本地文字）
└ `display_name_western_script`	`string`	展示姓名（西方文字）
└ `relationship`	`enum`	关系
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `gender`	`enum`	性别，枚举值可查询【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：gender - object_api_name：person
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `date_of_birth`	`string`	生日
└ `nationality_id_v2`	`string`	国籍 ID，可通过【查询国籍信息】接口查询
└ `national_id_list`	`national_id\[\]`	证件号码
└ `national_id_type_id`	`string`	国家证件类型，可通过【批量查询国家证件类型】获得
└ `national_id_number`	`string`	证件号码
└ `issue_date`	`string`	证件签发日期
└ `expiration_date`	`string`	证件到期日期
└ `country_region_id`	`string`	国家/地区，可通过【查询国家/地区信息】获取
└ `issued_by`	`string`	证件签发机构
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `spouses_working_status`	`enum`	配偶工作状态，可通过【获取字段详情】获取，查询参数： - custom_api_name：spouses_working_status - object_api_name：dependent
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `is_this_person_covered_by_health_insurance`	`boolean`	包含家属医疗保险
└ `is_this_person_allowed_for_tax_deduction`	`boolean`	允许家属抵扣税款
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `dependent_name`	`string`	家庭成员姓名
└ `employer`	`string`	工作单位
└ `job`	`string`	岗位
└ `phone`	`phone`	电话
└ `international_area_code`	`enum`	国家区号，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：international_area_code - object_api_name：phone
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_number`	`string`	电话号码
└ `formatted_phone_number`	`string`	完整电话号码
└ `device_type`	`enum`	设备类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：device_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_usage`	`enum`	电话用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：phone_usage
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `is_primary`	`boolean`	主要电话
└ `is_public`	`boolean`	公开电话
└ `address`	`address`	联系地址
└ `full_address_local_script`	`string`	完整地址（本地文字）
└ `full_address_western_script`	`string`	完整地址（西方文字）
└ `address_id`	`string`	地址 ID，在请求体值为空时生成新值，请注意保存
└ `country_region_id`	`string`	国家/地区，可通过【查询国家/地区信息】获取
└ `region_id`	`string`	主要行政区，可通过【查询省份/主要行政区信息】获取
└ `address_line1`	`string`	地址行 1
└ `address_line2`	`string`	地址行 2
└ `address_line3`	`string`	地址行 3
└ `address_line4`	`string`	地址行 4
└ `address_line5`	`string`	地址行 5
└ `address_line6`	`string`	地址行 6
└ `address_line7`	`string`	地址行 7
└ `address_line8`	`string`	地址行 8
└ `address_line9`	`string`	地址行 9
└ `local_address_line1`	`string`	地址行 1（非拉丁语系的本地文字）
└ `local_address_line2`	`string`	地址行 2（非拉丁语系的本地文字）
└ `local_address_line3`	`string`	地址行 3（非拉丁语系的本地文字）
└ `local_address_line4`	`string`	地址行 4（非拉丁语系的本地文字）
└ `local_address_line5`	`string`	地址行 5（非拉丁语系的本地文字）
└ `local_address_line6`	`string`	地址行 6（非拉丁语系的本地文字）
└ `local_address_line7`	`string`	地址行 7（非拉丁语系的本地文字）
└ `local_address_line8`	`string`	地址行 8（非拉丁语系的本地文字）
└ `local_address_line9`	`string`	地址行 9（非拉丁语系的本地文字）
└ `postal_code`	`string`	邮政编码
└ `address_type_list`	`enum\[\]`	地址类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：address - custom_api_name：address_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `is_primary`	`boolean`	主要地址
└ `is_public`	`boolean`	公开地址
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `birth_certificate_of_child`	`file\[\]`	出生证明
└ `id`	`string`	文件 ID，可用于【下载文件】
└ `name`	`string`	文件名
└ `emergency_contact_list`	`emergency_contact\[\]`	紧急联系人列表字段权限要求（满足任一）： `corehr:person.emergency_contact:read` 获取紧急联系人信息 `corehr:person.emergency_contact:write` 读写紧急联系人信息
└ `name`	`person_name`	姓名
└ `local_primary`	`string`	姓 - 本地文字
└ `local_first_name`	`string`	名 - 本地文字
└ `country_region_id`	`string`	国家/地区，可通过【查询国家/地区信息】获取
└ `name_type`	`enum`	姓名类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：person_name - custom_api_name：name_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `local_first_name_2`	`string`	名 - 第二本地文字
└ `local_primary_2`	`string`	姓 - 第二本地文字
└ `additional_name_type`	`enum`	补充姓名类型，可通过【获取字段详情】获取，查询参数： - custom_api_name：additional_name_type - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `first_name`	`string`	名
└ `full_name`	`string`	全名
└ `hereditary`	`string`	姓氏称谓
└ `custom_name`	`string`	自定义姓名（未传入时，姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接）
└ `custom_local_name`	`string`	本地文字的自定义姓名（未传入时，本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接）
└ `middle_name`	`string`	中间名
└ `name_primary`	`string`	姓
└ `secondary`	`string`	第二姓氏
└ `social`	`enum`	尊称，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `tertiary`	`string`	婚后姓氏
└ `title`	`enum`	头衔，可通过【获取字段详情】接口获取，按如下参数查询即可： - custom_api_name：social - object_api_name：person_name
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `local_middle_name`	`string`	本地中间名
└ `local_secondary`	`string`	第二姓氏 - 本地文字
└ `display_name_local_and_western_script`	`string`	展示姓名（本地和西方文字）
└ `display_name_local_script`	`string`	展示姓名（本地文字）
└ `display_name_western_script`	`string`	展示姓名（西方文字）
└ `relationship`	`enum`	关系 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：dependent - custom_api_name：relationship_with_dependent
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_ist`	`phone\[\]`	电话
└ `international_area_code`	`enum`	国家区号，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：international_area_code - object_api_name：phone
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_number`	`string`	电话号码
└ `formatted_phone_number`	`string`	完整电话号码
└ `device_type`	`enum`	设备类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：device_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_usage`	`enum`	电话用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：phone_usage
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `is_primary`	`boolean`	主要电话
└ `is_public`	`boolean`	公开电话
└ `phone_list`	`phone\[\]`	电话
└ `international_area_code`	`enum`	国家区号，可通过【获取字段详情】获取，按如下参数查询即可： - custom_api_name：international_area_code - object_api_name：phone
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_number`	`string`	电话号码
└ `formatted_phone_number`	`string`	完整电话号码
└ `device_type`	`enum`	设备类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：device_type
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `phone_usage`	`enum`	电话用途 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：phone - custom_api_name：phone_usage
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `is_primary`	`boolean`	主要电话
└ `is_public`	`boolean`	公开电话
└ `legal_name`	`string`	法定姓名
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `date_entered_workforce`	`string`	参加工作日期字段权限要求（满足任一）： `corehr:person.date_entered_workforce:read` 获取参加工作日期 `corehr:person.date_entered_workforce:write` 读写参加工作日期
└ `working_years`	`int`	工龄
└ `profile_image_id`	`string`	头像资源的 ID - 该字段已废弃
└ `email_address`	`string`	邮箱地址字段权限要求（满足任一）： `corehr:person.email:read` 获取个人邮箱信息 `corehr:person.email:write` 读写个人邮箱信息
└ `age`	`int`	年龄字段权限要求（满足任一）： `corehr:person.date_of_birth:read` 获取生日信息 `corehr:person.date_of_birth:write` 读写生日信息
└ `highest_level_of_education`	`education`	最高学历教育经历字段权限要求（满足任一）： `corehr:person.education:read` 获取教育经历信息 `corehr:person.education:write` 读写教育经历信息
└ `school`	`i18n\[\]`	学校
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `level_of_education`	`enum`	学历 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：level_of_education
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `start_date`	`string`	开始日期
└ `end_date`	`string`	结束日期
└ `field_of_study`	`i18n\[\]`	专业
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `degree`	`enum`	学位 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：degree
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `school_name`	`enum`	学校名称，可通过【获取字段详情】获取，查询参数： - custom_api_name：school_name - object_api_name：education
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `field_of_study_name`	`enum`	专业名称，可通过【获取字段详情】获取，查询参数： - custom_api_name：field_of_study_name - object_api_name：education
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `country_region_id`	`string`	国家地区 ID，可通过【查询国家/地区信息】接口查询获得
└ `expected_end_date`	`string`	预期结束日期
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `highest_degree_of_education`	`education`	最高学位教育经历字段权限要求（满足任一）： `corehr:person.education:read` 获取教育经历信息 `corehr:person.education:write` 读写教育经历信息
└ `school`	`i18n\[\]`	学校
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `level_of_education`	`enum`	学历 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：level_of_education
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `start_date`	`string`	开始日期
└ `end_date`	`string`	结束日期
└ `field_of_study`	`i18n\[\]`	专业
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `degree`	`enum`	学位 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name：education - custom_api_name：degree
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `school_name`	`enum`	学校名称，可通过【获取字段详情】获取，查询参数： - custom_api_name：school_name - object_api_name：education
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `field_of_study_name`	`enum`	专业名称，可通过【获取字段详情】获取，查询参数： - custom_api_name：field_of_study_name - object_api_name：education
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `country_region_id`	`string`	国家地区 ID，可通过【查询国家/地区信息】接口查询获得
└ `expected_end_date`	`string`	预期结束日期
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `personal_profile`	`personal_profile\[\]`	个人资料附件字段权限要求（满足任一）： `corehr:person.personal_profile:read` 获取个人资料信息 `corehr:person.personal_profile:write` 读写个人资料信息
└ `personal_profile_type`	`enum`	资料类型 - 可通过【获取字段详情】获取，查询参数： - custom_api_name：profile_type - object_api_name：personal_profile - 仅【飞书人事-档案配置-资料附件】存在的字段编码可用
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `files`	`file\[\]`	上传文件列表
└ `id`	`string`	上传文件 ID，可用于【下载文件】
└ `name`	`string`	文件名
└ `native_region`	`string`	籍贯 ID，详细信息可通过【查询省份/行政区信息】接口查询获得字段权限要求（满足任一）： `corehr:person.native_region:read` 获取籍贯信息 `corehr:person.native_region:write` 读写籍贯信息
└ `hukou_type`	`enum`	户口类型 - 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name: person_info_chn - custom_api_name: hukou_type 字段权限要求（满足任一）： `corehr:person.hukou:read` 获取户口信息 `corehr:person.hukou:write` 读写户口信息
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `hukou_location`	`string`	户口所在地字段权限要求（满足任一）： `corehr:person.hukou:read` 获取户口信息 `corehr:person.hukou:write` 读写户口信息
└ `talent_id`	`string`	人才 ID，可通过【获取人才信息】查询详细信息
└ `custom_fields`	`custom_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】字段权限要求（满足任一）： `corehr:person.custom_field:read` 获取个人信息自定义字段信息 `corehr:person.custom_field:write` 读写个人信息中的自定义字段信息
└ `custom_api_name`	`string`	自定义字段 apiname，即自定义字段的唯一标识
└ `name`	`custom_name`	自定义字段名称
└ `zh_cn`	`string`	中文
└ `en_us`	`string`	英文
└ `type`	`int`	自定义字段类型
└ `value`	`string`	字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考【操作手册】如何通过 OpenAPI 维护自定义字段
└ `national_id_number`	`string`	居民身份证件号码字段权限要求（满足任一）： `corehr:person.national_id:read` 获取证件信息 `corehr:person.national_id:write` 读写证件信息
└ `family_address`	`string`	家庭地址字段权限要求（满足任一）： `corehr:person.address:read` 读取个人地址信息 `corehr:person.address:write` 读写个人地址信息
└ `born_country_region`	`string`	出生国家 / 地区 ID - 可通过【查询国家/地区信息】接口获取字段权限要求（满足任一）： `corehr:person.born_country_region:read` 获取出生国家/地区信息 `corehr:person.born_country_region:write` 读写出生国家/地区信息
└ `is_disabled`	`boolean`	是否残疾字段权限要求（满足任一）： `corehr:person.is_disabled:read` 获取残疾信息 `corehr:person.is_disabled:write` 读写残疾信息
└ `disable_card_number`	`string`	残疾证号字段权限要求（满足任一）： `corehr:person.is_disabled:read` 获取残疾信息 `corehr:person.is_disabled:write` 读写残疾信息
└ `is_martyr_family`	`boolean`	是否烈属字段权限要求（满足任一）： `corehr:person.martyr_family:read` 获取烈属信息 `corehr:person.martyr_family:write` 读写烈属信息
└ `martyr_card_number`	`string`	烈属证号字段权限要求（满足任一）： `corehr:person.martyr_family:read` 获取烈属信息 `corehr:person.martyr_family:write` 读写烈属信息
└ `is_old_alone`	`boolean`	是否孤老字段权限要求（满足任一）： `corehr:person.is_old_alone:read` 获取孤老信息 `corehr:person.is_old_alone:write` 读写孤老信息
└ `resident_taxes`	`resident_tax\[\]`	居民身份信息字段权限要求（满足任一）： `corehr:person.resident_tax:read` 获取居民身份信息 `corehr:person.resident_tax:write` 读写居民身份信息
└ `year_resident_tax`	`string`	年度
└ `resident_status`	`enum`	居民身份，枚举值 api_name 可通过【获取字段详情】接口查询，查询参数如下： - object_api_name = "resident_tax" - custom_api_name = "resident_status"
└ `enum_name`	`string`	example
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	语言编码（IETF BCP 47）
└ `value`	`string`	文本内容
└ `tax_country_region_id`	`string`	国家/地区，可通过【查询国家/地区信息】接口查询
└ `custom_fields`	`object_field_data\[\]`	自定义字段 - 请参考【自定义字段说明】字段权限要求（满足任一）： `corehr:person.resident_tax_custom_field:read` 获取居民身份自定义字段信息 `corehr:person.resident_tax_custom_field:write` 读写居民身份自定义字段信息
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
└ `first_entry_time`	`string`	首次入境日期字段权限要求（满足任一）： `corehr:person.entry_leave_time:read` 获取出入境日期信息 `corehr:person.entry_leave_time:write` 读写出入境日期信息
└ `leave_time`	`string`	预计离境日期字段权限要求（满足任一）： `corehr:person.entry_leave_time:read` 获取出入境日期信息 `corehr:person.entry_leave_time:write` 读写出入境日期信息

响应体示例

json

{
    "code": 0,
    "msg": "success",
    "data": {
        "person": {
            "person_id": "6919733936050406926",
            "phone_number": "13649211111",
            "legal_name": "张三",
            "preferred_name": "刘梓新(Henry)",
            "preferred_local_full_name": "刘梓新",
            "preferred_english_full_name": "Henry",
            "name_list": [
                {
                    "local_primary": "黄",
                    "local_first_name": "四",
                    "country_region_id": "6862995757234914824",
                    "name_type": {
                        "enum_name": "legal_name",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "local_first_name_2": "五",
                    "local_primary_2": "王",
                    "additional_name_type": {
                        "enum_name": "legal_name",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "first_name": "帅",
                    "full_name": "王大帅",
                    "hereditary": "王",
                    "custom_name": "王大帅",
                    "custom_local_name": "王大帅",
                    "middle_name": "大",
                    "name_primary": "王",
                    "secondary": "王",
                    "social": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "tertiary": "王",
                    "title": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "local_middle_name": "大",
                    "local_secondary": "王",
                    "display_name_local_and_western_script": "王大帅",
                    "display_name_local_script": "王大帅",
                    "display_name_western_script": "王大帅"
                }
            ],
            "gender": {
                "enum_name": "male",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "中文示例"
                    }
                ]
            },
            "date_of_birth": "2020-01-01",
            "race": {
                "enum_name": "example",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "中文示例"
                    }
                ]
            },
            "marital_status": {
                "enum_name": "example",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "中文示例"
                    }
                ]
            },
            "phone_list": [
                {
                    "international_area_code": {
                        "enum_name": "86_china",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "phone_number": "010-12345678",
                    "formatted_phone_number": "+86 010-12345678",
                    "device_type": {
                        "enum_name": "mobile_phone",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "phone_usage": {
                        "enum_name": "home",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "is_primary": true,
                    "is_public": true
                }
            ],
            "address_list": [
                {
                    "full_address_local_script": "中国北京北京",
                    "full_address_western_script": "Beijing, Beijing, China,",
                    "address_id": "6989822217869624863",
                    "country_region_id": "6862995757234914824",
                    "region_id": "6863326815667095047",
                    "address_line1": "丹佛测试地址-纽埃时区",
                    "address_line2": "PoewH",
                    "address_line3": "PoewH",
                    "address_line4": "jmwJc",
                    "address_line5": "jmwJc",
                    "address_line6": "jmwJc",
                    "address_line7": "jmwJc",
                    "address_line8": "rafSu",
                    "address_line9": "McPRG",
                    "local_address_line1": "丹佛测试地址-纽埃时区",
                    "local_address_line2": "PoewH",
                    "local_address_line3": "PoewH",
                    "local_address_line4": "jmwJc",
                    "local_address_line5": "jmwJc",
                    "local_address_line6": "jmwJc",
                    "local_address_line7": "jmwJc",
                    "local_address_line8": "rafSu",
                    "local_address_line9": "McPRG",
                    "postal_code": "611530",
                    "address_type_list": [
                        {
                            "enum_name": "home_address",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        }
                    ],
                    "is_primary": true,
                    "is_public": true,
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                }
            ],
            "email_list": [
                {
                    "email": "1234567@example.feishu.cn",
                    "is_primary": true,
                    "is_public": true,
                    "email_usage": {
                        "enum_name": "home",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    }
                }
            ],
            "work_experience_list": [
                {
                    "company_organization": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "department": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "job": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "description": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "start_date": "2020-01-01",
                    "end_date": "2020-01-01",
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                }
            ],
            "education_list": [
                {
                    "school": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "level_of_education": {
                        "enum_name": "phd",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "start_date": "2011-09-01",
                    "end_date": "2015-06-30",
                    "field_of_study": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ],
                    "degree": {
                        "enum_name": "phd",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "school_name": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "field_of_study_name": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "country_region_id": "1",
                    "expected_end_date": "2011-09-01",
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                }
            ],
            "bank_account_list": [
                {
                    "bank_name": "中国农业银行",
                    "bank_account_number": "6231200000001223",
                    "account_holder": "孟十五",
                    "branch_name": "中国农业银行支行",
                    "bank_id_v2": "MDBH00000001",
                    "branch_id_v2": "MDBK00000017",
                    "country_region_id": "12",
                    "bank_account_usage": [
                        {
                            "enum_name": "payment",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        }
                    ],
                    "bank_account_type": {
                        "enum_name": "checking",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "currency_id": "12QueryCountryRegionSubdivisionDataReq",
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                }
            ],
            "national_id_list": [
                {
                    "national_id_type_id": "6863330041896371725",
                    "national_id_number": "1231131333",
                    "issue_date": "2020-04-01",
                    "expiration_date": "2020-05-21",
                    "country_region_id": "6862995757234914824",
                    "issued_by": "北京市公安局",
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                }
            ],
            "dependent_list": [
                {
                    "name": {
                        "local_primary": "黄",
                        "local_first_name": "四",
                        "country_region_id": "6862995757234914824",
                        "name_type": {
                            "enum_name": "legal_name",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "local_first_name_2": "五",
                        "local_primary_2": "王",
                        "additional_name_type": {
                            "enum_name": "legal_name",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "first_name": "帅",
                        "full_name": "王大帅",
                        "hereditary": "王",
                        "custom_name": "王大帅",
                        "custom_local_name": "王大帅",
                        "middle_name": "大",
                        "name_primary": "王",
                        "secondary": "王",
                        "social": {
                            "enum_name": "example",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "tertiary": "王",
                        "title": {
                            "enum_name": "example",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "local_middle_name": "大",
                        "local_secondary": "王",
                        "display_name_local_and_western_script": "王大帅",
                        "display_name_local_script": "王大帅",
                        "display_name_western_script": "王大帅"
                    },
                    "relationship": {
                        "enum_name": "parent",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "gender": {
                        "enum_name": "male",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "date_of_birth": "2020-01-01",
                    "nationality_id_v2": "6862995745046267401",
                    "national_id_list": [
                        {
                            "national_id_type_id": "6863330041896371725",
                            "national_id_number": "1231131333",
                            "issue_date": "2020-04-01",
                            "expiration_date": "2020-05-21",
                            "country_region_id": "6862995757234914824",
                            "issued_by": "北京市公安局",
                            "custom_fields": [
                                {
                                    "custom_api_name": "name",
                                    "name": {
                                        "zh_cn": "自定义姓名",
                                        "en_us": "Custom Name"
                                    },
                                    "type": 1,
                                    "value": "\"231\""
                                }
                            ]
                        }
                    ],
                    "spouses_working_status": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "is_this_person_covered_by_health_insurance": true,
                    "is_this_person_allowed_for_tax_deduction": false,
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ],
                    "dependent_name": "张三",
                    "employer": "海淀区交警大队",
                    "job": "保安",
                    "phone": {
                        "international_area_code": {
                            "enum_name": "86_china",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "phone_number": "010-12345678",
                        "formatted_phone_number": "+86 010-12345678",
                        "device_type": {
                            "enum_name": "mobile_phone",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "phone_usage": {
                            "enum_name": "home",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "is_primary": true,
                        "is_public": true
                    },
                    "address": {
                        "full_address_local_script": "中国北京北京",
                        "full_address_western_script": "Beijing, Beijing, China,",
                        "address_id": "6989822217869624863",
                        "country_region_id": "6862995757234914824",
                        "region_id": "6863326815667095047",
                        "address_line1": "丹佛测试地址-纽埃时区",
                        "address_line2": "PoewH",
                        "address_line3": "PoewH",
                        "address_line4": "jmwJc",
                        "address_line5": "jmwJc",
                        "address_line6": "jmwJc",
                        "address_line7": "jmwJc",
                        "address_line8": "rafSu",
                        "address_line9": "McPRG",
                        "local_address_line1": "丹佛测试地址-纽埃时区",
                        "local_address_line2": "PoewH",
                        "local_address_line3": "PoewH",
                        "local_address_line4": "jmwJc",
                        "local_address_line5": "jmwJc",
                        "local_address_line6": "jmwJc",
                        "local_address_line7": "jmwJc",
                        "local_address_line8": "rafSu",
                        "local_address_line9": "McPRG",
                        "postal_code": "611530",
                        "address_type_list": [
                            {
                                "enum_name": "home_address",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            }
                        ],
                        "is_primary": true,
                        "is_public": true,
                        "custom_fields": [
                            {
                                "custom_api_name": "name",
                                "name": {
                                    "zh_cn": "自定义姓名",
                                    "en_us": "Custom Name"
                                },
                                "type": 1,
                                "value": "\"231\""
                            }
                        ]
                    },
                    "birth_certificate_of_child": [
                        {
                            "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200",
                            "name": "document.txt"
                        }
                    ]
                }
            ],
            "emergency_contact_list": [
                {
                    "name": {
                        "local_primary": "黄",
                        "local_first_name": "四",
                        "country_region_id": "6862995757234914824",
                        "name_type": {
                            "enum_name": "legal_name",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "local_first_name_2": "五",
                        "local_primary_2": "王",
                        "additional_name_type": {
                            "enum_name": "legal_name",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "first_name": "帅",
                        "full_name": "王大帅",
                        "hereditary": "王",
                        "custom_name": "王大帅",
                        "custom_local_name": "王大帅",
                        "middle_name": "大",
                        "name_primary": "王",
                        "secondary": "王",
                        "social": {
                            "enum_name": "example",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "tertiary": "王",
                        "title": {
                            "enum_name": "example",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "中文示例"
                                }
                            ]
                        },
                        "local_middle_name": "大",
                        "local_secondary": "王",
                        "display_name_local_and_western_script": "王大帅",
                        "display_name_local_script": "王大帅",
                        "display_name_western_script": "王大帅"
                    },
                    "relationship": {
                        "enum_name": "parent",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "phone_ist": [
                        {
                            "international_area_code": {
                                "enum_name": "86_china",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "phone_number": "010-12345678",
                            "formatted_phone_number": "+86 010-12345678",
                            "device_type": {
                                "enum_name": "mobile_phone",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "phone_usage": {
                                "enum_name": "home",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "is_primary": true,
                            "is_public": true
                        }
                    ],
                    "phone_list": [
                        {
                            "international_area_code": {
                                "enum_name": "86_china",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "phone_number": "010-12345678",
                            "formatted_phone_number": "+86 010-12345678",
                            "device_type": {
                                "enum_name": "mobile_phone",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "phone_usage": {
                                "enum_name": "home",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "中文示例"
                                    }
                                ]
                            },
                            "is_primary": true,
                            "is_public": true
                        }
                    ],
                    "legal_name": "张三",
                    "custom_fields": [
                        {
                            "custom_api_name": "name",
                            "name": {
                                "zh_cn": "自定义姓名",
                                "en_us": "Custom Name"
                            },
                            "type": 1,
                            "value": "\"231\""
                        }
                    ]
                }
            ],
            "date_entered_workforce": "2020-10-01",
            "working_years": 2,
            "profile_image_id": "dfysuc8x76dsfsw",
            "email_address": "test@163.com",
            "age": 22,
            "highest_level_of_education": {
                "school": [
                    {
                        "lang": "zh-CN",
                        "value": "中文示例"
                    }
                ],
                "level_of_education": {
                    "enum_name": "phd",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "start_date": "2011-09-01",
                "end_date": "2015-06-30",
                "field_of_study": [
                    {
                        "lang": "zh-CN",
                        "value": "中文示例"
                    }
                ],
                "degree": {
                    "enum_name": "phd",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "school_name": {
                    "enum_name": "example",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "field_of_study_name": {
                    "enum_name": "example",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "country_region_id": "1",
                "expected_end_date": "2011-09-01",
                "custom_fields": [
                    {
                        "custom_api_name": "name",
                        "name": {
                            "zh_cn": "自定义姓名",
                            "en_us": "Custom Name"
                        },
                        "type": 1,
                        "value": "\"231\""
                    }
                ]
            },
            "highest_degree_of_education": {
                "school": [
                    {
                        "lang": "zh-CN",
                        "value": "中文示例"
                    }
                ],
                "level_of_education": {
                    "enum_name": "phd",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "start_date": "2011-09-01",
                "end_date": "2015-06-30",
                "field_of_study": [
                    {
                        "lang": "zh-CN",
                        "value": "中文示例"
                    }
                ],
                "degree": {
                    "enum_name": "phd",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "school_name": {
                    "enum_name": "example",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "field_of_study_name": {
                    "enum_name": "example",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "中文示例"
                        }
                    ]
                },
                "country_region_id": "1",
                "expected_end_date": "2011-09-01",
                "custom_fields": [
                    {
                        "custom_api_name": "name",
                        "name": {
                            "zh_cn": "自定义姓名",
                            "en_us": "Custom Name"
                        },
                        "type": 1,
                        "value": "\"231\""
                    }
                ]
            },
            "personal_profile": [
                {
                    "personal_profile_type": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "files": [
                        {
                            "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200",
                            "name": "document.txt"
                        }
                    ]
                }
            ],
            "native_region": "6863326262618752111",
            "hukou_type": {
                "enum_name": "local_urban_residence",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "中文示例"
                    }
                ]
            },
            "hukou_location": "山东省平阴县",
            "talent_id": "6863326262618752123",
            "custom_fields": [
                {
                    "custom_api_name": "name",
                    "name": {
                        "zh_cn": "自定义姓名",
                        "en_us": "Custom Name"
                    },
                    "type": 1,
                    "value": "\"231\""
                }
            ],
            "national_id_number": "11010000000000",
            "family_address": "6863326262618752123",
            "born_country_region": "6863326262618752123",
            "is_disabled": true,
            "disable_card_number": "1110000",
            "is_martyr_family": true,
            "martyr_card_number": "1110000",
            "is_old_alone": true,
            "resident_taxes": [
                {
                    "year_resident_tax": "2023",
                    "resident_status": {
                        "enum_name": "example",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "中文示例"
                            }
                        ]
                    },
                    "tax_country_region_id": "中国",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "Sandy"
                        }
                    ]
                }
            ],
            "first_entry_time": "2021-01-02",
            "leave_time": "2022-01-02"
        }
    }
}

错误码

HTTP状态码	错误码	描述	排查建议
400	1160001	param is invalid	请检查输入参数
400	1160021	param is invalid	请检查输入参数
400	1160022	param is invalid	请检查输入参数
400	1160004	request ID repeat	请检查参数client_token
400	1160017	No permission to modify data	请检查权限配置
500	1160999	internal server error	请联系技术支持

事件

事件

员工兼职

员工国际派遣

职位数据事件

事件

事件

事件

事件

事件

事件

事件

成本中心 · version

事件

事件

事件

事件

地点 · address

事件

事件

更新个人信息 ​

请求 ​

请求头 ​

路径参数 ​

查询参数 ​

请求体 ​

请求体示例 ​

响应 ​

响应体 ​

响应体示例 ​

错误码 ​

更新个人信息

请求

请求头

路径参数

查询参数

请求体

请求体示例

响应

响应体

响应体示例

错误码