# 创建个人信息
创建员工的个人信息，包括姓名、个人电话、邮箱、联系地址、政治面貌、户口信息等
**注意事项**：- 非必填字段，不传时默认为空
## 请求
基本 |
---|---
HTTP URL | https://open.feishu.cn/open-apis/corehr/v2/persons
HTTP Method | POST
接口频率限制 | [1000 次/分钟、50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用** | 读写员工的个人信息(corehr:person:write)
字段权限要求 | **注意事项**：该接口返回体中存在下列敏感字段，仅当开启对应的权限后才会返回；如果无需获取这些字段，则不建议申请
读取个人地址信息(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.passport_number:read)
获取个人资料信息(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.is_disabled:write)
读写出入境日期信息(corehr:person.entry_leave_time:write)
读写孤老信息(corehr:person.is_old_alone:write)
读写个人信息中的自定义字段信息(corehr:person.custom_field:write)
读写出生国家/地区信息(corehr:person.born_country_region:write)
### 请求头
名称 | 类型 | 必填 | 描述
---|---|---|---
Authorization | string | 是 | `tenant_access_token`
**值格式**："Bearer `access_token`"
**示例值**："Bearer t-7f1bcd13fc57d46bac21793a18e560"
[了解更多：如何选择与获取 access token](https://open.feishu.cn/document/uAjLw4CM/ugTN1YjL4UTN24CO1UjN/trouble-shooting/how-to-choose-which-type-of-token-to-use)
Content-Type | string | 是 | **固定值**："application/json; charset=utf-8"
### 查询参数
名称 | 类型 | 必填 | 描述
---|---|---|---
client_token | string | 否 | 操作的唯一标识，用于幂等的进行更新操作，格式为标准的 UUIDV4。此值为空表示将发起一次新的请求，此值非空表示幂等的进行更新操作。
**示例值**："fe599b60-450f-46ff-b2ef-9f6675625b97"
### 请求体
名称 | 类型 | 必填 | 描述
---|---|---|---
name_list | person_name\[\] | 否 | 姓名列表，当用于[【创建雇佣】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/employment/create) 的离职重聘时，该字段必填
**字段权限要求：**
读写法定姓名信息(corehr:person.legal_name:write)
local_primary | string | 否 | 姓 - 本地文字
**示例值**："黄"
local_first_name | string | 否 | 名 - 本地文字
**示例值**："四"
country_region_id | string | 是 | 国家/地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
**示例值**："6862995757234914824"
name_type | enum | 是 | 姓名类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 否 | 补充姓名类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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 | 否 | 尊称，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- custom_api_name：social
- object_api_name：person_name
**示例值**：王大帅
enum_name | string | 是 | 枚举值
**示例值**："example"
tertiary | string | 否 | 婚后姓氏
**示例值**："王"
title | enum | 否 | 头衔，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- custom_api_name：social
- object_api_name：person_name
**示例值**：王
enum_name | string | 是 | 枚举值
**示例值**："example"
local_middle_name | string | 否 | 本地中间名
**示例值**："大"
local_secondary | string | 否 | 第二姓氏 - 本地文字
**示例值**："王"
gender | enum | 否 | 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "person"
- custom_api_name = "gender"
**字段权限要求：**
读写性别信息(corehr:person.gender:write)
enum_name | string | 是 | 枚举值
**示例值**："male"
date_of_birth | string | 否 | 出生日期
**字段权限要求：**
读写生日信息(corehr:person.date_of_birth:write)
**示例值**："2020-01-01"
race | enum | 否 | 民族 / 种族，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "person"
- custom_api_name = "ethnicity_race"
enum_name | string | 是 | 枚举值
**示例值**："example"
marital_status | enum | 否 | 婚姻状况，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "person"
- custom_api_name = "marital_status"
**字段权限要求：**
读写婚姻状况信息(corehr:person.marital_status:write)
enum_name | string | 是 | 枚举值
**示例值**："example"
phone_list | phone\[\] | 否 | 电话列表
international_area_code | enum | 否 | 国家区号，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，按如下参数查询即可：
- custom_api_name：international_area_code
- object_api_name：phone
enum_name | string | 是 | 枚举值
**示例值**："86_china"
phone_number | string | 是 | 电话号码
**示例值**："010-12345678"
address_list | address\[\] | 否 | 地址列表
**字段权限要求：**
读取个人地址信息(corehr:person.address:write)
address_id | string | 否 | 地址 ID，首次创建可不填
**示例值**："6989822217869624863"
country_region_id | string | 是 | 国家/地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
**示例值**："6862995757234914824"
region_id | string | 否 | 主要行政区，可通过[【查询省份/主要行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)获取
**示例值**："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\[\] | 是 | 地址类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：address
- custom_api_name：address_type
- 默认：home_address
enum_name | string | 是 | 枚举值
**示例值**："home_address"
is_primary | boolean | 是 | 主要地址，默认 false
**示例值**：true
is_public | boolean | 是 | 公开地址，默认 true
**示例值**：true
custom_fields | custom_field_data\[\] | 否 | 自定义字段
- 具体支持的对象请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
email_list | email\[\] | 否 | 邮箱列表
**字段权限要求：**
读写个人邮箱信息(corehr:person.email:write)
email | string | 是 | 邮箱地址
**示例值**："1234567@example.feishu.cn"
is_primary | boolean | 否 | 是否为主要邮箱，默认 true
**示例值**：true
is_public | boolean | 否 | 是否为公开邮箱，默认 true
**示例值**：true
email_usage | enum | 否 | 邮箱用途
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name: email
- custom_api_name: email_usage
- 请勿填写 work 枚举，工作邮箱在雇佣信息中操作
- 默认：emergency_contact
enum_name | string | 是 | 枚举值
**示例值**："emergency_contact"
work_experience_list | work_experience_info\[\] | 否 | 工作经历列表
**字段权限要求：**
读写工作履历信息(corehr:person.work_experience:write)
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\[\] | 否 | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
education_list | education\[\] | 否 | 教育经历列表
**字段权限要求：**
读写教育经历信息(corehr:person.education:write)
school | i18n\[\] | 是 | 学校
- 如果学校有对应枚举，请使用 school_name 字段
lang | string | 是 | 语言编码（IETF BCP 47）
**示例值**："zh-CN"
value | string | 是 | 文本内容
**示例值**："中文示例"
level_of_education | enum | 否 | 学历
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 否 | 学位
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：education
- custom_api_name：degree
enum_name | string | 是 | 枚举值
**示例值**："mba"
school_name | enum | 否 | 学校名称
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- custom_api_name：school_name
- object_api_name：education
- 如果学校有对应枚举，请使用该字段，否则可使用 school 直接写入文本
enum_name | string | 是 | 枚举值
**示例值**："example"
field_of_study_name | enum | 否 | 专业名称
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- custom_api_name：field_of_study_name
- object_api_name：education
- 如果专业有对应枚举，请使用该字段，否则可使用 field_of_study 直接写入文本
enum_name | string | 是 | 枚举值
**示例值**："example"
country_region_id | string | 否 | 国家/地区ID，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
**示例值**："1"
expected_end_date | string | 否 | 预期结束日期
**示例值**："2011-09-01"
custom_fields | custom_field_data\[\] | 否 | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
bank_account_list | bank_account\[\] | 否 | 银行账户
**字段权限要求：**
读写银行账号列表信息(corehr:person.bank_account:write)
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，可通过[【查询银行信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank/search)接口查询获得
**示例值**："MDBH00000001"
branch_id_v2 | string | 否 | 支行 ID，要求必须为填入银行的支行，可通过[【查询支行信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank_branch/search)接口查询获得
**示例值**："MDBK00000017"
country_region_id | string | 否 | 国家/地区ID，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
**示例值**："12"
bank_account_usage | enum\[\] | 否 | 银行卡类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name: bank_account
- custom_api_name: bank_account_type
enum_name | string | 是 | 枚举值
**示例值**："payment"
bank_account_type | enum | 否 | 银行卡类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name: bank_account
- custom_api_name: bank_account_type
enum_name | string | 是 | 枚举值
**示例值**："checking"
currency_id | string | 否 | 货币 ID
- 详细信息可通过[【查询货币信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-currency/search)接口查询获得
**示例值**："12QueryCountryRegionSubdivisionDataReq"
custom_fields | custom_field_data\[\] | 否 | 自定义字段
- 具体支持的对象请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
national_id_list | national_id\[\] | 否 | 证件列表
**字段权限要求：**
读写证件信息(corehr:person.national_id:write)
national_id_type_id | string | 是 | 国家证件类型，可通过[【批量查询国家证件类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/list)获得
**示例值**："6863330041896371725"
national_id_number | string | 是 | 证件号码
**示例值**："1231131333"
issue_date | string | 否 | 证件签发日期
**示例值**："2020-04-01"
expiration_date | string | 否 | 证件到期日期
**示例值**："2020-05-21"
country_region_id | string | 是 | 国家/地区ID，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
**示例值**："6862995757234914824"
issued_by | string | 否 | 证件签发机构
**示例值**："北京市公安局"
custom_fields | custom_field_data\[\] | 否 | 自定义字段
- 具体支持的对象请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
dependent_list | dependent\[\] | 否 | 家庭成员列表
**字段权限要求：**
读写家庭成员信息(corehr:person.dependent:write)
relationship | enum | 是 | 亲属关系
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：dependent
- custom_api_name：relationship_with_dependent
enum_name | string | 是 | 枚举值
**示例值**："parent"
gender | enum | 否 | 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "person"
- custom_api_name = "gender"
enum_name | string | 是 | 枚举值
**示例值**："male"
date_of_birth | string | 否 | 生日
**示例值**："2020-01-01"
nationality_id_v2 | string | 否 | 国籍 ID，可通过[【查询国籍信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询
**示例值**："6862995745046267401"
national_id_list | national_id\[\] | 否 | 证件号码
national_id_type_id | string | 是 | 国家证件类型，可通过[【批量查询国家证件类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/list)获得
**示例值**："6863330041896371725"
national_id_number | string | 是 | 证件号码
**示例值**："1231131333"
issue_date | string | 否 | 证件签发日期
**示例值**："2020-04-01"
expiration_date | string | 否 | 证件到期日期
**示例值**："2020-05-21"
country_region_id | string | 是 | 国家/地区ID，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
**示例值**："6862995757234914824"
issued_by | string | 否 | 证件签发机构
**示例值**："北京市公安局"
custom_fields | custom_field_data\[\] | 否 | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
spouses_working_status | enum | 否 | 配偶工作状态，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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\[\] | 否 | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
dependent_name | string | 否 | 家庭成员姓名
**示例值**："张三"
employer | string | 否 | 工作单位
**示例值**："海淀区交警大队"
job | string | 否 | 岗位
**示例值**："保安"
phone | phone | 否 | 电话
international_area_code | enum | 否 | 国家区号，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，按如下参数查询即可：
- 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，在[【创建个人信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/person/create)、[【更新个人信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/person/patch)时可获得
**示例值**："6989822217869624863"
country_region_id | string | 是 | 国家/地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
**示例值**："6862995757234914824"
region_id | string | 否 | 主要行政区，可通过[【查询省份/主要行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)获取
**示例值**："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\[\] | 否 | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
birth_certificate_of_child | file\[\] | 否 | 出生证明
id | string | 否 | 上传文件ID，可通过[【上传文件】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/person/upload)获取
**示例值**："150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
emergency_contact_list | emergency_contact\[\] | 否 | 紧急联系人列表
**字段权限要求：**
读写紧急联系人信息(corehr:person.emergency_contact:write)
name | person_name | 否 | 姓名
- 该字段已废弃，请使用 legal_name
local_primary | string | 否 | 姓 - 本地文字
**示例值**："黄"
local_first_name | string | 否 | 名 - 本地文字
**示例值**："四"
country_region_id | string | 是 | 国家/地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
**示例值**："6862995757234914824"
name_type | enum | 是 | 姓名类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 否 | 补充姓名类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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 | 否 | 尊称，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- custom_api_name：social
- object_api_name：person_name
**示例值**：王大帅
enum_name | string | 是 | 枚举值
**示例值**："example"
tertiary | string | 否 | 婚后姓氏
**示例值**："王"
title | enum | 否 | 头衔，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- custom_api_name：social
- object_api_name：person_name
**示例值**：王
enum_name | string | 是 | 枚举值
**示例值**："example"
local_middle_name | string | 否 | 本地中间名
**示例值**："大"
local_secondary | string | 否 | 第二姓氏 - 本地文字
**示例值**："王"
relationship | enum | 否 | 关系
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：dependent
- custom_api_name：relationship_with_dependent
enum_name | string | 是 | 枚举值
**示例值**："parent"
phone_ist | phone\[\] | 否 | 电话
international_area_code | enum | 否 | 国家区号，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，按如下参数查询即可：
- 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\[\] | 否 | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
date_entered_workforce | string | 否 | 参加工作日期
**字段权限要求：**
读写参加工作日期(corehr:person.date_entered_workforce:write)
**示例值**："2020-10-01"
profile_image_id | string | 否 | 头像资源的 ID
- 该字段已废弃
**示例值**："dfysuc8x76dsfsw"
personal_profile | personal_profile\[\] | 否 | 个人资料附件
**字段权限要求：**
读写个人资料信息(corehr:person.personal_profile:write)
personal_profile_type | enum | 否 | 资料类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- custom_api_name：profile_type
- object_api_name：personal_profile
- 仅 【飞书人事-档案配置-资料附件】存在的字段编码可用
enum_name | string | 是 | 枚举值
**示例值**："example"
files | file\[\] | 否 | 上传文件列表
id | string | 否 | 上传文件ID
**示例值**："150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
native_region | string | 否 | 籍贯 ID，可通过[【查询省份/主要行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/subdivision/get)接口查询
**字段权限要求：**
读写籍贯信息(corehr:person.native_region:write)
**示例值**："6863326262618752111"
hukou_type | enum | 否 | 户口类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name: person_info_chn
- custom_api_name: hukou_type
**字段权限要求：**
读写户口信息(corehr:person.hukou:write)
enum_name | string | 是 | 枚举值
**示例值**："local_urban_residence"
hukou_location | string | 否 | 户口所在地
**字段权限要求：**
读写户口信息(corehr:person.hukou:write)
**示例值**："山东省平阴县"
political_affiliations | enum\[\] | 否 | 政治面貌
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：person_info_chn
- custom_api_name：political_affiliation
enum_name | string | 是 | 枚举值
**示例值**："communist_party_of_china"
talent_id | string | 否 | 人才ID，可通过[【获取人才列表】](https://open.feishu.cn/document/ukTMukTMukTM/uMzM1YjLzMTN24yMzUjN/hire-v1/talent/list)获取
**示例值**："6863326262618752123"
custom_fields | custom_field_data\[\] | 否 | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 是 | 自定义字段 apiname，即自定义字段的唯一标识
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："\"231\""
born_country_region | string | 否 | 出生国家/地区
**示例值**："中国"
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 | 否 | 居民身份，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "resident_tax"
- custom_api_name = "resident_status"
enum_name | string | 是 | 枚举值
**示例值**："example"
tax_country_region_id | string | 否 | 国家/地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询
**示例值**："中国"
custom_fields | object_field_data\[\] | 否 | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
field_name | string | 是 | 字段名
**示例值**："name"
value | string | 是 | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
**示例值**："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，可通过[【批量查询员工信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/employee/batch_get)获取详细信息
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 | 国家 / 地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取详细信息
name_type | enum | 姓名类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 补充姓名类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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 | 尊称，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 头衔，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "person"
- custom_api_name = "gender"
**字段权限要求（满足任一）**：
获取性别信息(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 | 民族 / 种族，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "person"
- custom_api_name = "ethnicity_race"
**字段权限要求**：
获取民族/种族信息(corehr:person.race:read)
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
marital_status | enum | 婚姻状况，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "person"
- custom_api_name = "marital_status"
**字段权限要求：**
读写婚姻状况信息(corehr:person.marital_status:write)
**字段权限要求（满足任一）**：
获取婚姻状况信息(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 | 国家区号，枚举值 api_name 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "phone"
- custom_api_name = "international_area_code"
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
phone_number | string | 电话号码
formatted_phone_number | string | 完整电话号码
device_type | enum | 设备类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：phone
- custom_api_name：device_type
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
phone_usage | enum | 电话用途
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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，可用于[【更新个人信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/person/patch)联系地址更新
country_region_id | string | 国家 / 地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)查询
region_id | string | 主要行政区，可通过[【查询省份/主要行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)查询
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\[\] | 地址类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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\[\] | 自定义字段
- 具体支持的对象请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
email_list | email\[\] | 邮箱列表
**字段权限要求（满足任一）**：
获取个人邮箱信息(corehr:person.email:read)
读写个人邮箱信息(corehr:person.email:write)
email | string | 邮箱地址
is_primary | boolean | 是否为主要邮箱
is_public | boolean | 是否为公开邮箱
email_usage | enum | 邮箱用途
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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\[\] | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
education_list | education\[\] | 教育经历列表
**字段权限要求（满足任一）**：
获取教育经历信息(corehr:person.education:read)
读写教育经历信息(corehr:person.education:write)
school | i18n\[\] | 学校
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
level_of_education | enum | 学历
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 学位
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：education
- custom_api_name：degree
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
school_name | enum | 学校名称，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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 | 专业名称，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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，详细信息可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询获得
expected_end_date | string | 预期结束日期
custom_fields | custom_field_data\[\] | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
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，详细信息可通过[【查询银行信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank/search)接口查询获得
branch_id_v2 | string | 支行 ID，要求必须为填入银行的支行，详细信息可通过[【查询支行信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-bank_branch/search)接口查询获得
country_region_id | string | 国家/地区 ID，详细信息可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询获得
bank_account_usage | enum\[\] | 银行卡用途
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 银行卡类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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，详细信息可通过[【查询货币信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-currency/search)接口查询获得
custom_fields | custom_field_data\[\] | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
national_id_list | national_id\[\] | 证件
**字段权限要求（满足任一）**：
获取证件信息(corehr:person.national_id:read)
读写证件信息(corehr:person.national_id:write)
national_id_type_id | string | 国家证件类型，可通过[【查询单个国家证件类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/get)获取详细信息
national_id_number | string | 证件号码
issue_date | string | 证件签发日期
expiration_date | string | 证件到期日期
country_region_id | string | 国家/地区ID，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
issued_by | string | 证件签发机构
custom_fields | custom_field_data\[\] | 自定义字段
- 具体支持的对象请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
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，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
name_type | enum | 姓名类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 补充姓名类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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 | 尊称，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 头衔，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 关系
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：dependent
- custom_api_name：relationship_with_dependent
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
gender | enum | 性别，枚举值可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name = "person"
- custom_api_name = "gender"
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
date_of_birth | string | 生日
nationality_id_v2 | string | 国籍 ID，可通过[【查询国籍信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-nationality/search)接口查询
national_id_list | national_id\[\] | 证件号码
national_id_type_id | string | 国家证件类型，可通过[【查询单个国家证件类型】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/national_id_type/get)获取详细信息
national_id_number | string | 证件号码
issue_date | string | 证件签发日期
expiration_date | string | 证件到期日期
country_region_id | string | 国家/地区ID，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
issued_by | string | 证件签发机构
custom_fields | custom_field_data\[\] | 自定义字段
- 具体支持的对象请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
spouses_working_status | enum | 配偶工作状态，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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\[\] | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
dependent_name | string | 家庭成员姓名
employer | string | 工作单位
job | string | 岗位
phone | phone | 电话
international_area_code | enum | 国家区号
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
phone_number | string | 电话号码
formatted_phone_number | string | 完整电话号码
device_type | enum | 设备类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：phone
- custom_api_name：device_type
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
phone_usage | enum | 电话用途
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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，在[【更新个人信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/person/patch)-家庭联系地址时使用
country_region_id | string | 国家/地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
region_id | string | 主要行政区，可通过[【查询省份/主要行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)获取
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\[\] | 地址类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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\[\] | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
birth_certificate_of_child | file\[\] | 出生证明
id | string | 文件 ID，可用于[【下载文件】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/file/get)
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 | 国家/地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)获取
name_type | enum | 姓名类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 补充姓名类型，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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 | 尊称，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 头衔，可通过 [【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口获取，按如下参数查询即可：
- 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 | 关系
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 国家区号，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，按如下参数查询即可：
- 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 | 设备类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：phone
- custom_api_name：device_type
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
phone_usage | enum | 电话用途
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 国家区号，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，按如下参数查询即可：
- 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 | 设备类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：phone
- custom_api_name：device_type
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
phone_usage | enum | 电话用途
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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\[\] | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
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 | 学历
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 学位
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：education
- custom_api_name：degree
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
school_name | enum | 学校名称，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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 | 专业名称，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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，详细信息可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询获得
expected_end_date | string | 预期结束日期
custom_fields | custom_field_data\[\] | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
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 | 学历
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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 | 学位
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- object_api_name：education
- custom_api_name：degree
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
school_name | enum | 学校名称，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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 | 专业名称，可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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，详细信息可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询获得
expected_end_date | string | 预期结束日期
custom_fields | custom_field_data\[\] | 自定义字段
- 具体支持的对象请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
custom_api_name | string | 自定义字段 apiname，即自定义字段的唯一标识
name | custom_name | 自定义字段名称
zh_cn | string | 中文
en_us | string | 英文
type | int | 自定义字段类型
value | string | 字段值，是 json 转义后的字符串，根据元数据定义不同，字段格式不同。使用方式可参考[【操作手册】如何通过 OpenAPI 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
personal_profile | personal_profile\[\] | 个人资料附件
**字段权限要求（满足任一）**：
获取个人资料信息(corehr:person.personal_profile:read)
读写个人资料信息(corehr:person.personal_profile:write)
personal_profile_type | enum | 资料类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)获取，查询参数：
- 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，可用于[【下载文件】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/file/get)
name | string | 文件名
native_region | string | 籍贯 ID，详细信息可通过[【查询省份/行政区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region_subdivision/search)接口查询获得
**字段权限要求（满足任一）**：
获取籍贯信息(corehr:person.native_region:read)
读写籍贯信息(corehr:person.native_region:write)
hukou_type | enum | 户口类型
- 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下：
- 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\[\] | 自定义字段
- 请参考[【自定义字段说明】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom-fields-guide)
**字段权限要求（满足任一）**：
获取个人信息自定义字段信息(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 维护自定义字段](https://feishu.feishu.cn/docx/QlUudBfCtosWMbxx3vxcOFDknn7)
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 | 出生国家/地区
**字段权限要求（满足任一）**：
获取出生国家/地区信息(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 可通过[【获取字段详情】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/custom_field/get_by_param)接口查询，查询参数如下： - object_api_name = "resident_tax" - custom_api_name = "resident_status"
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 语言编码（IETF BCP 47）
value | string | 文本内容
tax_country_region_id | string | 国家/地区，可通过[【查询国家/地区信息】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/basic_info-country_region/search)接口查询
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)
passport_number | string | 护照号码
**字段权限要求**：
获取护照号码(corehr:person.passport_number:read)
### 响应体示例
```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": "example",
"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": "mba",
"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": "checking",
"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": "fax",
"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": "emergency_contact_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": "fax",
"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": "fax",
"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@example.feishu.cn",
"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": "mba",
"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": "mba",
"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": "example",
"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": "中国",
"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",
"passport_number": "6919733936050406926"
}
}
}
```
### 错误码
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 | 请联系[技术支持](https://applink.feishu.cn/TLJpeNdW)