更新个人信息

更新个人信息。

Error: 接口已升级，推荐使用：更新个人信息

请求

项目	值
HTTP URL	https://open.feishu.cn/open-apis/corehr/v1/persons/:person_id
HTTP Method	PATCH
接口频率限制	1000 次/分钟、50 次/秒
支持的应用类型	custom
权限要求调用该 API 所需的权限。开启其中任意一项权限即可调用	`corehr:corehr` 更新核心人事信息

请求头

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

路径参数

名称	类型	描述
`person_id`	`string`	person的ID 示例值："6969828847931885087"

查询参数

名称	类型	必填	描述
`client_token`	`string`	否	根据client_token是否一致来判断是否为同一请求示例值：12454646

请求体

名称	类型	必填	描述
`name_list`	`person_name\[\]`	否	姓名
└ `local_primary`	`string`	否	姓 - 本地文字示例值："黄"
└ `local_first_name`	`string`	否	名 - 本地文字示例值："四"
└ `country_region_id`	`string`	是	国家 / 地区示例值："6862995757234914824"
└ `name_type`	`enum`	是	姓名类型，枚举值可通过文档【飞书人事枚举常量】姓名类型（name_type）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `local_first_name_2`	`string`	否	名 - 第二本地文字示例值："五"
└ `local_primary_2`	`string`	否	姓 - 第二本地文字示例值："王"
└ `additional_name_type`	`enum`	否	补充姓名类型，比如emergency_contact_name（紧急联系人姓名）
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `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`	否	尊称示例值：刘梓新
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `tertiary`	`string`	否	婚后姓氏示例值："王"
└ `title`	`enum`	否	头衔，比如 Mr. Miss. Mrs. Prof. Dr. 示例值：王
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `local_middle_name`	`string`	否	本地中间名示例值："大"
└ `local_secondary`	`string`	否	第二姓氏 - 本地文字示例值："王"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
`gender`	`enum`	否	性别，枚举值可通过文档【飞书人事枚举常量】性别（gender）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
`date_of_birth`	`string`	否	出生日期示例值："2020-01-01"
`nationality_id`	`string`	否	国籍id 示例值："123456789"
`race`	`enum`	否	民族 / 种族，枚举值可通过文档【飞书人事枚举常量】民族（race）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
`marital_status`	`enum`	否	婚姻状况，枚举值可通过文档【飞书人事枚举常量】婚姻状况（marital_status）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
`phone_list`	`phone\[\]`	否	电话列表，只有当满足下面所有条件时，电话在个人信息页才可见: - 电话号码不为空 - is_primary = "true" - phone_usage = "home"
└ `international_area_code`	`enum`	否	国家区号常见如：86_china（中国）、852_hong_kong（中国香港）、886_taiwan（中国台湾）、853_macao（中国澳门）、1_united_states_of_america（美利坚合众国）、7_russian_federation（俄罗斯联邦）、44_united_kingdom（英国）、81_japan（日本）、82_korea_republic_of（大韩民国）、91_india（印度）
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `phone_number`	`string`	是	电话号码示例值："010-12345678"
└ `device_type`	`enum`	否	设备类型，枚举值可通过文档【飞书人事枚举常量】设备类型（device_type）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `phone_usage`	`enum`	否	电话用途，枚举值可通过文档【飞书人事枚举常量】电话用途（phone_usage）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `is_primary`	`boolean`	否	是否为主要电话示例值：true
└ `is_public`	`boolean`	否	是否为公开电话示例值：true
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
`address_list`	`address\[\]`	否	地址列表
└ `country_region_id`	`string`	是	国家 / 地区示例值："6862995757234914824"
└ `region_id`	`string`	否	主要行政区示例值："6863326815667095047"
└ `city_id`	`string`	否	城市示例值："6863333254578046471"
└ `distinct_id`	`string`	否	区/县示例值："6863333516579440141"
└ `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`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
`email_list`	`email\[\]`	否	邮箱列表
└ `email`	`string`	是	邮箱号示例值："12456@test.com"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
`work_experience_list`	`work_experience\[\]`	否	工作履历列表
└ `company_organization`	`i18n\[\]`	否	公司 / 组织
└ `lang`	`string`	是	名称信息的语言示例值："zh-CN"
└ `value`	`string`	是	名称信息的内容示例值："张三"
└ `department`	`i18n\[\]`	否	部门
└ `lang`	`string`	是	名称信息的语言示例值："zh-CN"
└ `value`	`string`	是	名称信息的内容示例值："张三"
└ `job`	`i18n\[\]`	否	岗位
└ `lang`	`string`	是	名称信息的语言示例值："zh-CN"
└ `value`	`string`	是	名称信息的内容示例值："张三"
└ `description`	`i18n\[\]`	否	工作描述
└ `lang`	`string`	是	名称信息的语言示例值："zh-CN"
└ `value`	`string`	是	名称信息的内容示例值："张三"
└ `start_date`	`string`	否	开始日期示例值："2020-01-01"
└ `end_date`	`string`	否	结束日期示例值："2020-01-01"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
`education_list`	`education\[\]`	否	教育经历列表
└ `school`	`i18n\[\]`	是	学校
└ `lang`	`string`	是	名称信息的语言示例值："zh-CN"
└ `value`	`string`	是	名称信息的内容示例值："张三"
└ `level_of_education`	`enum`	否	学历，枚举值可通过文档【飞书人事枚举常量】学历（level_of_education）枚举定义获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `start_date`	`string`	否	开始日期示例值："2011-09-01"
└ `end_date`	`string`	否	结束日期示例值："2015-06-30"
└ `field_of_study`	`i18n\[\]`	否	专业
└ `lang`	`string`	是	名称信息的语言示例值："zh-CN"
└ `value`	`string`	是	名称信息的内容示例值："张三"
└ `degree`	`enum`	否	学位，枚举值可通过文档【飞书人事枚举常量】学位（degree）枚举定义获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `school_name`	`enum`	否	学校名称
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `field_of_study_name`	`enum`	否	专业名称
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `country_region_id`	`string`	否	国家地区ID 示例值："1"
└ `expected_end_date`	`string`	否	预期结束日期示例值："2011-09-01"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
`bank_account_list`	`bank_account\[\]`	否	银行账号
└ `bank_name`	`string`	否	银行名称，如果已经填入银行枚举，该字段可为空。如果要填写数据不在系统提供的枚举范围内，该字段存储自定义银行名称示例值："中国农业银行"
└ `bank_account_number`	`string`	是	银行账号示例值："6231200000001223"
└ `account_holder`	`string`	是	开户人姓名示例值："孟十五"
└ `bank`	`enum`	否	银行枚举，常见的银行枚举如：bank-5（交通银行）、bank-6（中国银行）、bank-7（中国建设银行）、bank-8（中国农业银行）、bank-9（中国工商银行）、bank-10（中国邮政储蓄银行）、bank-11（中国光大银行）、bank-12（中国民生银行）、bank-13（招商银行）、bank-14（中信银行）、bank-15（华夏银行）
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `branch_name`	`string`	否	支行名称示例值："中国农业银行支行"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
└ `country_region_id`	`string`	否	国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得示例值："12"
└ `bank_account_usage`	`enum\[\]`	否	银行卡用途，枚举值可通过文档【飞书人事枚举常量】银行卡用途（bank_account_usage）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `bank_account_type`	`enum`	否	银行卡类型，枚举值可通过文档【飞书人事枚举常量】银行卡类型（bank_account_type）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `currency_id`	`string`	否	货币id 示例值："12QueryCountryRegionSubdivisionDataReq"
`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`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
`dependent_list`	`dependent\[\]`	否	亲属列表
└ `name`	`person_name`	否	亲属姓名
└ `local_primary`	`string`	否	姓 - 本地文字示例值："黄"
└ `local_first_name`	`string`	否	名 - 本地文字示例值："四"
└ `country_region_id`	`string`	是	国家 / 地区示例值："6862995757234914824"
└ `name_type`	`enum`	是	姓名类型，枚举值可通过文档【飞书人事枚举常量】姓名类型（name_type）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `local_first_name_2`	`string`	否	名 - 第二本地文字示例值："五"
└ `local_primary_2`	`string`	否	姓 - 第二本地文字示例值："王"
└ `additional_name_type`	`enum`	否	补充姓名类型，比如emergency_contact_name（紧急联系人姓名）
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `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`	否	尊称示例值：刘梓新
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `tertiary`	`string`	否	婚后姓氏示例值："王"
└ `title`	`enum`	否	头衔，比如 Mr. Miss. Mrs. Prof. Dr. 示例值：王
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `local_middle_name`	`string`	否	本地中间名示例值："大"
└ `local_secondary`	`string`	否	第二姓氏 - 本地文字示例值："王"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
└ `relationship`	`enum`	是	亲属关系，枚举值可通过文档【飞书人事枚举常量】亲属关系（relationship）枚举定义获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `gender`	`enum`	否	亲属性别，枚举值可通过文档【飞书人事枚举常量】性别（gender）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `date_of_birth`	`string`	否	生日示例值："2020-01-01"
└ `nationality_id`	`string`	否	国籍示例值："7075702734054164011"
└ `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`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
└ `spouses_working_status`	`enum`	否	配偶工作状态，比如working（在岗）、not_working（不在岗）
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `is_this_person_covered_by_health_insurance`	`boolean`	否	包含家属医疗保险示例值：true
└ `is_this_person_allowed_for_tax_deduction`	`boolean`	否	允许家属抵扣税款示例值：false
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
└ `dependent_name`	`string`	否	家庭成员姓名示例值："张三"
└ `employer`	`string`	否	工作单位示例值："海淀区交警大队"
└ `job`	`string`	否	岗位示例值："保安"
└ `phone`	`phone`	否	电话
└ `international_area_code`	`enum`	否	国家区号常见如：86_china（中国）、852_hong_kong（中国香港）、886_taiwan（中国台湾）、853_macao（中国澳门）、1_united_states_of_america（美利坚合众国）、7_russian_federation（俄罗斯联邦）、44_united_kingdom（英国）、81_japan（日本）、82_korea_republic_of（大韩民国）、91_india（印度）
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `phone_number`	`string`	是	电话号码示例值："010-12345678"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
└ `address`	`address`	否	联系地址
└ `id`	`string`	否	地址ID 示例值："6989822217869624863"
└ `country_region_id`	`string`	是	国家 / 地区示例值："6862995757234914824"
└ `region_id`	`string`	否	主要行政区示例值："6863326815667095047"
└ `city_id`	`string`	否	城市示例值："6863333254578046471"
└ `distinct_id`	`string`	否	区/县示例值："6863333516579440141"
└ `local_address_line1`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："丹佛测试地址-纽埃时区"
└ `local_address_line2`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："PoewH"
└ `local_address_line3`	`string`	否	地址行 1（非拉丁语系的本地文字）示例值："丹佛测试地址-纽埃时区"
└ `local_address_line4`	`string`	否	地址行 2（非拉丁语系的本地文字）示例值："PoewH"
└ `local_address_line5`	`string`	否	地址行 3（非拉丁语系的本地文字）示例值："PoewH"
└ `local_address_line6`	`string`	否	地址行 4（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line7`	`string`	否	地址行 5（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line8`	`string`	否	地址行 6（非拉丁语系的本地文字）示例值："jmwJc"
└ `local_address_line9`	`string`	否	地址行 7（非拉丁语系的本地文字）示例值："jmwJc"
└ `postal_code`	`string`	否	地址行 8（非拉丁语系的本地文字）示例值："rafSu"
└ `custom_fields`	`object_field_data\[\]`	否	地址行 9（非拉丁语系的本地文字）示例值：McPRG
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05]) 示例值："Sandy"
└ `birth_certificate_of_child`	`file\[\]`	否	出生证明
└ `id`	`string`	否	上传文件ID 示例值："150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
`emergency_contact_list`	`emergency_contact\[\]`	否	紧急联系人列表
└ `name`	`person_name`	否	紧急联系人姓名
└ `local_primary`	`string`	否	姓 - 本地文字示例值："黄"
└ `local_first_name`	`string`	否	名 - 本地文字示例值："四"
└ `country_region_id`	`string`	是	国家 / 地区示例值："6862995757234914824"
└ `name_type`	`enum`	是	姓名类型，枚举值可通过文档【飞书人事枚举常量】姓名类型（name_type）枚举定义部分获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `local_first_name_2`	`string`	否	名 - 第二本地文字示例值："五"
└ `local_primary_2`	`string`	否	姓 - 第二本地文字示例值："王"
└ `additional_name_type`	`enum`	否	补充姓名类型，比如emergency_contact_name（紧急联系人姓名）
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `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`	否	尊称示例值：刘梓新
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `tertiary`	`string`	否	婚后姓氏示例值："王"
└ `title`	`enum`	否	头衔，比如 Mr. Miss. Mrs. Prof. Dr. 示例值：王
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `local_middle_name`	`string`	否	本地中间名示例值："大"
└ `local_secondary`	`string`	否	第二姓氏 - 本地文字示例值："王"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
└ `relationship`	`enum`	否	紧急联系人与本人亲属关系，枚举值可通过文档【飞书人事枚举常量】亲属关系（relationship）枚举定义获得
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `phone_ist`	`phone\[\]`	否	紧急联系人电话
└ `international_area_code`	`enum`	否	国家区号常见如：86_china（中国）、852_hong_kong（中国香港）、886_taiwan（中国台湾）、853_macao（中国澳门）、1_united_states_of_america（美利坚合众国）、7_russian_federation（俄罗斯联邦）、44_united_kingdom（英国）、81_japan（日本）、82_korea_republic_of（大韩民国）、91_india（印度）
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `phone_number`	`string`	是	电话号码示例值："010-12345678"
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
└ `custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
└ `legal_name`	`string`	否	法定姓名示例值："张三"
`date_entered_workforce`	`string`	否	参加工作日期示例值："2020-10-01"
`profile_image_id`	`string`	否	头像资源的 ID 示例值："dfysuc8x76dsfsw"
`custom_fields`	`object_field_data\[\]`	否	自定义字段
└ `field_name`	`string`	是	字段名示例值："name"
└ `value`	`string`	是	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05") 示例值：""Sandy""
`resident_tax_id_list`	`string\[\]`	否	纳税身份信息示例值：["123456"]
`age`	`int`	否	年龄示例值：25
`personal_profile`	`personal_profile\[\]`	否	个人资料
└ `personal_profile_type`	`enum`	否	个人资料类型，比如银行储蓄卡复印件、证件照、个人信息采集表、生活照
└ `enum_name`	`string`	是	枚举值示例值："type_1"
└ `files`	`file\[\]`	否	上传文件列表
└ `id`	`string`	否	上传文件ID 示例值："150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"

请求体示例

json

{
    "name_list": [
        {
            "local_primary": "黄",
            "local_first_name": "四",
            "country_region_id": "6862995757234914824",
            "name_type": {
                "enum_name": "type_1"
            },
            "local_first_name_2": "五",
            "local_primary_2": "王",
            "additional_name_type": {
                "enum_name": "type_1"
            },
            "first_name": "帅",
            "full_name": "刘梓新",
            "hereditary": "王",
            "custom_name": "刘梓新",
            "custom_local_name": "刘梓新",
            "middle_name": "大",
            "name_primary": "王",
            "secondary": "王",
            "social": {
                "enum_name": "type_1"
            },
            "tertiary": "王",
            "title": {
                "enum_name": "type_1"
            },
            "local_middle_name": "大",
            "local_secondary": "王",
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ]
        }
    ],
    "gender": {
        "enum_name": "type_1"
    },
    "date_of_birth": "2020-01-01",
    "nationality_id": "123456789",
    "race": {
        "enum_name": "type_1"
    },
    "marital_status": {
        "enum_name": "type_1"
    },
    "phone_list": [
        {
            "international_area_code": {
                "enum_name": "type_1"
            },
            "phone_number": "010-12345678",
            "device_type": {
                "enum_name": "type_1"
            },
            "phone_usage": {
                "enum_name": "type_1"
            },
            "is_primary": true,
            "is_public": true,
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ]
        }
    ],
    "address_list": [
        {
            "country_region_id": "6862995757234914824",
            "region_id": "6863326815667095047",
            "city_id": "6863333254578046471",
            "distinct_id": "6863333516579440141",
            "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": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ]
        }
    ],
    "email_list": [
        {
            "email": "12456@test.com",
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ]
        }
    ],
    "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": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ]
        }
    ],
    "education_list": [
        {
            "school": [
                {
                    "lang": "zh-CN",
                    "value": "张三"
                }
            ],
            "level_of_education": {
                "enum_name": "type_1"
            },
            "start_date": "2011-09-01",
            "end_date": "2015-06-30",
            "field_of_study": [
                {
                    "lang": "zh-CN",
                    "value": "张三"
                }
            ],
            "degree": {
                "enum_name": "type_1"
            },
            "school_name": {
                "enum_name": "type_1"
            },
            "field_of_study_name": {
                "enum_name": "type_1"
            },
            "country_region_id": "1",
            "expected_end_date": "2011-09-01",
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ]
        }
    ],
    "bank_account_list": [
        {
            "bank_name": "中国农业银行",
            "bank_account_number": "6231200000001223",
            "account_holder": "孟十五",
            "bank": {
                "enum_name": "type_1"
            },
            "branch_name": "中国农业银行支行",
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ],
            "country_region_id": "12",
            "bank_account_usage": [
                {
                    "enum_name": "type_1"
                }
            ],
            "bank_account_type": {
                "enum_name": "type_1"
            },
            "currency_id": "12QueryCountryRegionSubdivisionDataReq"
        }
    ],
    "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": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ]
        }
    ],
    "dependent_list": [
        {
            "name": {
                "local_primary": "黄",
                "local_first_name": "四",
                "country_region_id": "6862995757234914824",
                "name_type": {
                    "enum_name": "type_1"
                },
                "local_first_name_2": "五",
                "local_primary_2": "王",
                "additional_name_type": {
                    "enum_name": "type_1"
                },
                "first_name": "帅",
                "full_name": "刘梓新",
                "hereditary": "王",
                "custom_name": "刘梓新",
                "custom_local_name": "刘梓新",
                "middle_name": "大",
                "name_primary": "王",
                "secondary": "王",
                "social": {
                    "enum_name": "type_1"
                },
                "tertiary": "王",
                "title": {
                    "enum_name": "type_1"
                },
                "local_middle_name": "大",
                "local_secondary": "王",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "\"Sandy\""
                    }
                ]
            },
            "relationship": {
                "enum_name": "type_1"
            },
            "gender": {
                "enum_name": "type_1"
            },
            "date_of_birth": "2020-01-01",
            "nationality_id": "7075702734054164011",
            "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": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "spouses_working_status": {
                "enum_name": "type_1"
            },
            "is_this_person_covered_by_health_insurance": true,
            "is_this_person_allowed_for_tax_deduction": false,
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ],
            "dependent_name": "张三",
            "employer": "海淀区交警大队",
            "job": "保安",
            "phone": {
                "international_area_code": {
                    "enum_name": "type_1"
                },
                "phone_number": "010-12345678",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "\"Sandy\""
                    }
                ]
            },
            "address": {
                "id": "6989822217869624863",
                "country_region_id": "6862995757234914824",
                "region_id": "6863326815667095047",
                "city_id": "6863333254578046471",
                "distinct_id": "6863333516579440141",
                "local_address_line1": "丹佛测试地址-纽埃时区",
                "local_address_line2": "PoewH",
                "local_address_line3": "丹佛测试地址-纽埃时区",
                "local_address_line4": "PoewH",
                "local_address_line5": "PoewH",
                "local_address_line6": "jmwJc",
                "local_address_line7": "jmwJc",
                "local_address_line8": "jmwJc",
                "local_address_line9": "jmwJc",
                "postal_code": "rafSu",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "Sandy"
                    }
                ]
            },
            "birth_certificate_of_child": [
                {
                    "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
                }
            ]
        }
    ],
    "emergency_contact_list": [
        {
            "name": {
                "local_primary": "黄",
                "local_first_name": "四",
                "country_region_id": "6862995757234914824",
                "name_type": {
                    "enum_name": "type_1"
                },
                "local_first_name_2": "五",
                "local_primary_2": "王",
                "additional_name_type": {
                    "enum_name": "type_1"
                },
                "first_name": "帅",
                "full_name": "刘梓新",
                "hereditary": "王",
                "custom_name": "刘梓新",
                "custom_local_name": "刘梓新",
                "middle_name": "大",
                "name_primary": "王",
                "secondary": "王",
                "social": {
                    "enum_name": "type_1"
                },
                "tertiary": "王",
                "title": {
                    "enum_name": "type_1"
                },
                "local_middle_name": "大",
                "local_secondary": "王",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "\"Sandy\""
                    }
                ]
            },
            "relationship": {
                "enum_name": "type_1"
            },
            "phone_ist": [
                {
                    "international_area_code": {
                        "enum_name": "type_1"
                    },
                    "phone_number": "010-12345678",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ],
            "legal_name": "张三"
        }
    ],
    "date_entered_workforce": "2020-10-01",
    "profile_image_id": "dfysuc8x76dsfsw",
    "custom_fields": [
        {
            "field_name": "name",
            "value": "\"Sandy\""
        }
    ],
    "resident_tax_id_list": [
        "123456"
    ],
    "age": 25,
    "personal_profile": [
        {
            "personal_profile_type": {
                "enum_name": "type_1"
            },
            "files": [
                {
                    "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
                }
            ]
        }
    ]
}

响应

响应体

名称	类型	描述
`code`	`int`	错误码，非 0 表示失败
`msg`	`string`	错误描述
`data`	`\-`	-
└ `person`	`person`	个人信息
└ `phone_number`	`string`	个人手机号
└ `legal_name`	`string`	法定姓名
└ `preferred_name`	`string`	常用名展示中英文混合名，示例值：张三(Zhang San)
└ `id`	`string`	Person ID
└ `name_list`	`person_name\[\]`	姓名
└ `local_primary`	`string`	姓 - 本地文字
└ `local_first_name`	`string`	名 - 本地文字
└ `country_region_id`	`string`	国家 / 地区
└ `name_type`	`enum`	姓名类型，枚举值可通过文档【飞书人事枚举常量】姓名类型（name_type）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `local_first_name_2`	`string`	名 - 第二本地文字
└ `local_primary_2`	`string`	姓 - 第二本地文字
└ `additional_name_type`	`enum`	补充姓名类型，比如emergency_contact_name（紧急联系人姓名）
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `first_name`	`string`	名
└ `full_name`	`string`	全名
└ `hereditary`	`string`	姓氏称谓
└ `middle_name`	`string`	中间名
└ `name_primary`	`string`	姓
└ `secondary`	`string`	第二姓氏
└ `social`	`enum`	尊称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `tertiary`	`string`	婚后姓氏
└ `title`	`enum`	头衔，比如 Mr. Miss. Mrs. Prof. Dr.
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `local_middle_name`	`string`	本地中间名
└ `local_secondary`	`string`	第二姓氏 - 本地文字
└ `display_name_local_and_western_script`	`string`	展示姓名（本地和西方文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_local_name 字段的值，如果为空则取 custom_name 的值 - 非中国姓名，根据该国家/地区的规则自动将 local_primary、local_first_name、name_primary、first_name 等字段拼接在一起
└ `display_name_local_script`	`string`	展示姓名（本地文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_local_name 字段的值 - 非中国姓名，根据该国家/地区的规则自动将 local_primary、local_first_name 等字段拼接在一起
└ `display_name_western_script`	`string`	展示姓名（西方文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_name 字段的值 - 非中国姓名，根据该国家/地区的规则自动将 name_primary、first_name 等字段拼接在一起
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `gender`	`enum`	性别，枚举值可通过文档【飞书人事枚举常量】性别（gender）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `date_of_birth`	`string`	出生日期
└ `nationality_id`	`string`	国籍id
└ `race`	`enum`	民族 / 种族，枚举值可通过文档【飞书人事枚举常量】民族（race）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `marital_status`	`enum`	婚姻状况，枚举值可通过文档【飞书人事枚举常量】婚姻状况（marital_status）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `phone_list`	`phone\[\]`	电话列表，只有当满足下面所有条件时，电话在个人信息页才可见: - 电话号码不为空 - is_primary = "true" - phone_usage = "home"
└ `international_area_code`	`enum`	国家区号常见如：86_china（中国）、852_hong_kong（中国香港）、886_taiwan（中国台湾）、853_macao（中国澳门）、1_united_states_of_america（美利坚合众国）、7_russian_federation（俄罗斯联邦）、44_united_kingdom（英国）、81_japan（日本）、82_korea_republic_of（大韩民国）、91_india（印度）
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `phone_number`	`string`	电话号码
└ `formatted_phone_number`	`string`	完整电话号码
└ `device_type`	`enum`	设备类型，枚举值可通过文档【飞书人事枚举常量】设备类型（device_type）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `phone_usage`	`enum`	电话用途，枚举值可通过文档【飞书人事枚举常量】电话用途（phone_usage）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `is_primary`	`boolean`	是否为主要电话
└ `is_public`	`boolean`	是否为公开电话
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `address_list`	`address\[\]`	地址列表
└ `full_address_local_script`	`string`	完整地址（本地文字）
└ `full_address_western_script`	`string`	完整地址（西方文字）
└ `id`	`string`	地址ID
└ `country_region_id`	`string`	国家 / 地区
└ `region_id`	`string`	主要行政区
└ `city_id`	`string`	城市
└ `distinct_id`	`string`	区/县
└ `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`	邮政编码
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `email_list`	`email\[\]`	邮箱列表
└ `email`	`string`	邮箱号
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `work_experience_list`	`work_experience\[\]`	工作履历列表
└ `company_organization`	`i18n\[\]`	公司 / 组织
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `department`	`i18n\[\]`	部门
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `job`	`i18n\[\]`	岗位
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `description`	`i18n\[\]`	工作描述
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `start_date`	`string`	开始日期
└ `end_date`	`string`	结束日期
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `education_list`	`education\[\]`	教育经历列表
└ `school`	`i18n\[\]`	学校
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `level_of_education`	`enum`	学历，枚举值可通过文档【飞书人事枚举常量】学历（level_of_education）枚举定义获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `start_date`	`string`	开始日期
└ `end_date`	`string`	结束日期
└ `field_of_study`	`i18n\[\]`	专业
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `degree`	`enum`	学位，枚举值可通过文档【飞书人事枚举常量】学位（degree）枚举定义获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `school_name`	`enum`	学校名称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `field_of_study_name`	`enum`	专业名称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `country_region_id`	`string`	国家地区ID
└ `expected_end_date`	`string`	预期结束日期
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `bank_account_list`	`bank_account\[\]`	银行账号
└ `bank_name`	`string`	银行名称，如果已经填入银行枚举，该字段可为空。如果要填写数据不在系统提供的枚举范围内，该字段存储自定义银行名称
└ `bank_account_number`	`string`	银行账号
└ `account_holder`	`string`	开户人姓名
└ `bank`	`enum`	银行枚举，常见的银行枚举如：bank-5（交通银行）、bank-6（中国银行）、bank-7（中国建设银行）、bank-8（中国农业银行）、bank-9（中国工商银行）、bank-10（中国邮政储蓄银行）、bank-11（中国光大银行）、bank-12（中国民生银行）、bank-13（招商银行）、bank-14（中信银行）、bank-15（华夏银行）
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `branch_name`	`string`	支行名称
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `country_region_id`	`string`	国家/地区id，详细信息可通过【查询国家/地区信息】接口查询获得
└ `bank_account_usage`	`enum\[\]`	银行卡用途，枚举值可通过文档【飞书人事枚举常量】银行卡用途（bank_account_usage）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `bank_account_type`	`enum`	银行卡类型，枚举值可通过文档【飞书人事枚举常量】银行卡类型（bank_account_type）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `currency_id`	`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`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `dependent_list`	`dependent\[\]`	亲属列表
└ `name`	`person_name`	亲属姓名
└ `local_primary`	`string`	姓 - 本地文字
└ `local_first_name`	`string`	名 - 本地文字
└ `country_region_id`	`string`	国家 / 地区
└ `name_type`	`enum`	姓名类型，枚举值可通过文档【飞书人事枚举常量】姓名类型（name_type）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `local_first_name_2`	`string`	名 - 第二本地文字
└ `local_primary_2`	`string`	姓 - 第二本地文字
└ `additional_name_type`	`enum`	补充姓名类型，比如emergency_contact_name（紧急联系人姓名）
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `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`	尊称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `tertiary`	`string`	婚后姓氏
└ `title`	`enum`	头衔，比如 Mr. Miss. Mrs. Prof. Dr.
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `local_middle_name`	`string`	本地中间名
└ `local_secondary`	`string`	第二姓氏 - 本地文字
└ `display_name_local_and_western_script`	`string`	展示姓名（本地和西方文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_local_name 字段的值，如果为空则取 custom_name 的值 - 非中国姓名，根据该国家/地区的规则自动将 local_primary、local_first_name、name_primary、first_name 等字段拼接在一起
└ `display_name_local_script`	`string`	展示姓名（本地文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_local_name 字段的值 - 非中国姓名，根据该国家/地区的规则自动将 local_primary、local_first_name 等字段拼接在一起
└ `display_name_western_script`	`string`	展示姓名（西方文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_name 字段的值 - 非中国姓名，根据该国家/地区的规则自动将 name_primary、first_name 等字段拼接在一起
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `relationship`	`enum`	亲属关系，枚举值可通过文档【飞书人事枚举常量】亲属关系（relationship）枚举定义获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `gender`	`enum`	亲属性别，枚举值可通过文档【飞书人事枚举常量】性别（gender）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `date_of_birth`	`string`	生日
└ `nationality_id`	`string`	国籍
└ `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`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `spouses_working_status`	`enum`	配偶工作状态，比如working（在岗）、not_working（不在岗）
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `is_this_person_covered_by_health_insurance`	`boolean`	包含家属医疗保险
└ `is_this_person_allowed_for_tax_deduction`	`boolean`	允许家属抵扣税款
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `dependent_name`	`string`	家庭成员姓名
└ `employer`	`string`	工作单位
└ `job`	`string`	岗位
└ `phone`	`phone`	电话
└ `international_area_code`	`enum`	国家区号常见如：86_china（中国）、852_hong_kong（中国香港）、886_taiwan（中国台湾）、853_macao（中国澳门）、1_united_states_of_america（美利坚合众国）、7_russian_federation（俄罗斯联邦）、44_united_kingdom（英国）、81_japan（日本）、82_korea_republic_of（大韩民国）、91_india（印度）
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `phone_number`	`string`	电话号码
└ `formatted_phone_number`	`string`	完整电话号码
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `address`	`address`	联系地址
└ `full_address_local_script`	`string`	完整地址（本地文字）
└ `full_address_western_script`	`string`	完整地址（西方文字）
└ `id`	`string`	地址ID
└ `country_region_id`	`string`	国家 / 地区
└ `region_id`	`string`	主要行政区
└ `city_id`	`string`	城市
└ `distinct_id`	`string`	区/县
└ `local_address_line1`	`string`	地址行 1（非拉丁语系的本地文字）
└ `local_address_line2`	`string`	地址行 2（非拉丁语系的本地文字）
└ `local_address_line3`	`string`	地址行 1（非拉丁语系的本地文字）
└ `local_address_line4`	`string`	地址行 2（非拉丁语系的本地文字）
└ `local_address_line5`	`string`	地址行 3（非拉丁语系的本地文字）
└ `local_address_line6`	`string`	地址行 4（非拉丁语系的本地文字）
└ `local_address_line7`	`string`	地址行 5（非拉丁语系的本地文字）
└ `local_address_line8`	`string`	地址行 6（非拉丁语系的本地文字）
└ `local_address_line9`	`string`	地址行 7（非拉丁语系的本地文字）
└ `postal_code`	`string`	地址行 8（非拉丁语系的本地文字）
└ `custom_fields`	`object_field_data\[\]`	地址行 9（非拉丁语系的本地文字）
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
└ `birth_certificate_of_child`	`file\[\]`	出生证明
└ `id`	`string`	上传文件ID
└ `emergency_contact_list`	`emergency_contact\[\]`	紧急联系人列表
└ `name`	`person_name`	紧急联系人姓名
└ `local_primary`	`string`	姓 - 本地文字
└ `local_first_name`	`string`	名 - 本地文字
└ `country_region_id`	`string`	国家 / 地区
└ `name_type`	`enum`	姓名类型，枚举值可通过文档【飞书人事枚举常量】姓名类型（name_type）枚举定义部分获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `local_first_name_2`	`string`	名 - 第二本地文字
└ `local_primary_2`	`string`	姓 - 第二本地文字
└ `additional_name_type`	`enum`	补充姓名类型，比如emergency_contact_name（紧急联系人姓名）
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `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`	尊称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `tertiary`	`string`	婚后姓氏
└ `title`	`enum`	头衔，比如 Mr. Miss. Mrs. Prof. Dr.
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `local_middle_name`	`string`	本地中间名
└ `local_secondary`	`string`	第二姓氏 - 本地文字
└ `display_name_local_and_western_script`	`string`	展示姓名（本地和西方文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_local_name 字段的值，如果为空则取 custom_name 的值 - 非中国姓名，根据该国家/地区的规则自动将 local_primary、local_first_name、name_primary、first_name 等字段拼接在一起
└ `display_name_local_script`	`string`	展示姓名（本地文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_local_name 字段的值 - 非中国姓名，根据该国家/地区的规则自动将 local_primary、local_first_name 等字段拼接在一起
└ `display_name_western_script`	`string`	展示姓名（西方文字），按照如下规则自动计算得到 - 中国（包括中国香港、中国澳门、中国台湾）姓名，默认取 custom_name 字段的值 - 非中国姓名，根据该国家/地区的规则自动将 name_primary、first_name 等字段拼接在一起
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `relationship`	`enum`	紧急联系人与本人亲属关系，枚举值可通过文档【飞书人事枚举常量】亲属关系（relationship）枚举定义获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `phone_ist`	`phone\[\]`	紧急联系人电话
└ `international_area_code`	`enum`	国家区号常见如：86_china（中国）、852_hong_kong（中国香港）、886_taiwan（中国台湾）、853_macao（中国澳门）、1_united_states_of_america（美利坚合众国）、7_russian_federation（俄罗斯联邦）、44_united_kingdom（英国）、81_japan（日本）、82_korea_republic_of（大韩民国）、91_india（印度）
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `phone_number`	`string`	电话号码
└ `formatted_phone_number`	`string`	完整电话号码
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `legal_name`	`string`	法定姓名
└ `date_entered_workforce`	`string`	参加工作日期
└ `profile_image_id`	`string`	头像资源的 ID
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `email_address`	`string`	邮箱
└ `resident_tax_id_list`	`string\[\]`	纳税身份信息
└ `age`	`int`	年龄
└ `highest_level_of_education`	`education`	最高学历教育
└ `school`	`i18n\[\]`	学校
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `level_of_education`	`enum`	学历，枚举值可通过文档【飞书人事枚举常量】学历（level_of_education）枚举定义获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `start_date`	`string`	开始日期
└ `end_date`	`string`	结束日期
└ `field_of_study`	`i18n\[\]`	专业
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `degree`	`enum`	学位，枚举值可通过文档【飞书人事枚举常量】学位（degree）枚举定义获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `school_name`	`enum`	学校名称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `field_of_study_name`	`enum`	专业名称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `country_region_id`	`string`	国家地区ID
└ `expected_end_date`	`string`	预期结束日期
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `highest_degree_of_education`	`education`	最高学位教育经历
└ `school`	`i18n\[\]`	学校
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `level_of_education`	`enum`	学历，枚举值可通过文档【飞书人事枚举常量】学历（level_of_education）枚举定义获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `start_date`	`string`	开始日期
└ `end_date`	`string`	结束日期
└ `field_of_study`	`i18n\[\]`	专业
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `degree`	`enum`	学位，枚举值可通过文档【飞书人事枚举常量】学位（degree）枚举定义获得
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `school_name`	`enum`	学校名称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `field_of_study_name`	`enum`	专业名称
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `country_region_id`	`string`	国家地区ID
└ `expected_end_date`	`string`	预期结束日期
└ `custom_fields`	`object_field_data\[\]`	自定义字段
└ `field_name`	`string`	字段名
└ `value`	`string`	字段值，是json转义后的字符串，根据元数据定义不同，字段格式不同(如123, 123.23, "true", ["id1","id2"], "2006-01-02 15:04:05")
└ `personal_profile`	`personal_profile\[\]`	个人资料
└ `personal_profile_id`	`string`	个人资料 ID
└ `personal_profile_type`	`enum`	个人资料类型，比如银行储蓄卡复印件、证件照、个人信息采集表、生活照
└ `enum_name`	`string`	枚举值
└ `display`	`i18n\[\]`	枚举多语展示
└ `lang`	`string`	名称信息的语言
└ `value`	`string`	名称信息的内容
└ `files`	`file\[\]`	上传文件列表
└ `id`	`string`	上传文件ID

响应体示例

json

{
    "code": 0,
    "msg": "success",
    "data": {
        "person": {
            "phone_number": "11111111111",
            "legal_name": "张三",
            "preferred_name": "张四",
            "id": "646465654545",
            "name_list": [
                {
                    "local_primary": "黄",
                    "local_first_name": "四",
                    "country_region_id": "6862995757234914824",
                    "name_type": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "local_first_name_2": "五",
                    "local_primary_2": "王",
                    "additional_name_type": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "first_name": "帅",
                    "full_name": "刘梓新",
                    "hereditary": "王",
                    "middle_name": "大",
                    "name_primary": "王",
                    "secondary": "王",
                    "social": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "tertiary": "王",
                    "title": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "local_middle_name": "大",
                    "local_secondary": "王",
                    "display_name_local_and_western_script": "刘梓新",
                    "display_name_local_script": "刘梓新",
                    "display_name_western_script": "刘梓新",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "gender": {
                "enum_name": "type_1",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ]
            },
            "date_of_birth": "2020-01-01",
            "nationality_id": "123456789",
            "race": {
                "enum_name": "type_1",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ]
            },
            "marital_status": {
                "enum_name": "type_1",
                "display": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ]
            },
            "phone_list": [
                {
                    "international_area_code": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "phone_number": "010-12345678",
                    "formatted_phone_number": "+86 010-12345678",
                    "device_type": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "phone_usage": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "is_primary": true,
                    "is_public": true,
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "address_list": [
                {
                    "full_address_local_script": "中国北京北京",
                    "full_address_western_script": "Beijing, Beijing, China,",
                    "id": "6989822217869624863",
                    "country_region_id": "6862995757234914824",
                    "region_id": "6863326815667095047",
                    "city_id": "6863333254578046471",
                    "distinct_id": "6863333516579440141",
                    "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": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "email_list": [
                {
                    "email": "12456@test.com",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "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": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "education_list": [
                {
                    "school": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ],
                    "level_of_education": {
                        "enum_name": "type_1",
                        "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": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "school_name": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "field_of_study_name": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "country_region_id": "1",
                    "expected_end_date": "2011-09-01",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "bank_account_list": [
                {
                    "bank_name": "中国农业银行",
                    "bank_account_number": "6231200000001223",
                    "account_holder": "孟十五",
                    "bank": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "branch_name": "中国农业银行支行",
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ],
                    "country_region_id": "12",
                    "bank_account_usage": [
                        {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        }
                    ],
                    "bank_account_type": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "currency_id": "12QueryCountryRegionSubdivisionDataReq"
                }
            ],
            "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": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ]
                }
            ],
            "dependent_list": [
                {
                    "name": {
                        "local_primary": "黄",
                        "local_first_name": "四",
                        "country_region_id": "6862995757234914824",
                        "name_type": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "local_first_name_2": "五",
                        "local_primary_2": "王",
                        "additional_name_type": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "first_name": "帅",
                        "full_name": "刘梓新",
                        "hereditary": "王",
                        "custom_name": "刘梓新",
                        "custom_local_name": "刘梓新",
                        "middle_name": "大",
                        "name_primary": "王",
                        "secondary": "王",
                        "social": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "tertiary": "王",
                        "title": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "local_middle_name": "大",
                        "local_secondary": "王",
                        "display_name_local_and_western_script": "刘梓新",
                        "display_name_local_script": "刘梓新",
                        "display_name_western_script": "刘梓新",
                        "custom_fields": [
                            {
                                "field_name": "name",
                                "value": "\"Sandy\""
                            }
                        ]
                    },
                    "relationship": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "gender": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "date_of_birth": "2020-01-01",
                    "nationality_id": "7075702734054164011",
                    "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": [
                                {
                                    "field_name": "name",
                                    "value": "\"Sandy\""
                                }
                            ]
                        }
                    ],
                    "spouses_working_status": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "is_this_person_covered_by_health_insurance": true,
                    "is_this_person_allowed_for_tax_deduction": false,
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ],
                    "dependent_name": "张三",
                    "employer": "海淀区交警大队",
                    "job": "保安",
                    "phone": {
                        "international_area_code": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "phone_number": "010-12345678",
                        "formatted_phone_number": "+86 010-12345678",
                        "custom_fields": [
                            {
                                "field_name": "name",
                                "value": "\"Sandy\""
                            }
                        ]
                    },
                    "address": {
                        "full_address_local_script": "中国北京北京",
                        "full_address_western_script": "Beijing, Beijing, China,",
                        "id": "6989822217869624863",
                        "country_region_id": "6862995757234914824",
                        "region_id": "6863326815667095047",
                        "city_id": "6863333254578046471",
                        "distinct_id": "6863333516579440141",
                        "local_address_line1": "丹佛测试地址-纽埃时区",
                        "local_address_line2": "PoewH",
                        "local_address_line3": "丹佛测试地址-纽埃时区",
                        "local_address_line4": "PoewH",
                        "local_address_line5": "PoewH",
                        "local_address_line6": "jmwJc",
                        "local_address_line7": "jmwJc",
                        "local_address_line8": "jmwJc",
                        "local_address_line9": "jmwJc",
                        "postal_code": "rafSu",
                        "custom_fields": [
                            {
                                "field_name": "name",
                                "value": "Sandy"
                            }
                        ]
                    },
                    "birth_certificate_of_child": [
                        {
                            "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
                        }
                    ]
                }
            ],
            "emergency_contact_list": [
                {
                    "name": {
                        "local_primary": "黄",
                        "local_first_name": "四",
                        "country_region_id": "6862995757234914824",
                        "name_type": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "local_first_name_2": "五",
                        "local_primary_2": "王",
                        "additional_name_type": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "first_name": "帅",
                        "full_name": "刘梓新",
                        "hereditary": "王",
                        "custom_name": "刘梓新",
                        "custom_local_name": "刘梓新",
                        "middle_name": "大",
                        "name_primary": "王",
                        "secondary": "王",
                        "social": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "tertiary": "王",
                        "title": {
                            "enum_name": "type_1",
                            "display": [
                                {
                                    "lang": "zh-CN",
                                    "value": "张三"
                                }
                            ]
                        },
                        "local_middle_name": "大",
                        "local_secondary": "王",
                        "display_name_local_and_western_script": "刘梓新",
                        "display_name_local_script": "刘梓新",
                        "display_name_western_script": "刘梓新",
                        "custom_fields": [
                            {
                                "field_name": "name",
                                "value": "\"Sandy\""
                            }
                        ]
                    },
                    "relationship": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "phone_ist": [
                        {
                            "international_area_code": {
                                "enum_name": "type_1",
                                "display": [
                                    {
                                        "lang": "zh-CN",
                                        "value": "张三"
                                    }
                                ]
                            },
                            "phone_number": "010-12345678",
                            "formatted_phone_number": "+86 010-12345678",
                            "custom_fields": [
                                {
                                    "field_name": "name",
                                    "value": "\"Sandy\""
                                }
                            ]
                        }
                    ],
                    "custom_fields": [
                        {
                            "field_name": "name",
                            "value": "\"Sandy\""
                        }
                    ],
                    "legal_name": "张三"
                }
            ],
            "date_entered_workforce": "2020-10-01",
            "profile_image_id": "dfysuc8x76dsfsw",
            "custom_fields": [
                {
                    "field_name": "name",
                    "value": "\"Sandy\""
                }
            ],
            "email_address": "test@163.com",
            "resident_tax_id_list": [
                "123456"
            ],
            "age": 25,
            "highest_level_of_education": {
                "school": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ],
                "level_of_education": {
                    "enum_name": "type_1",
                    "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": "type_1",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "school_name": {
                    "enum_name": "type_1",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "field_of_study_name": {
                    "enum_name": "type_1",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "country_region_id": "1",
                "expected_end_date": "2011-09-01",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "\"Sandy\""
                    }
                ]
            },
            "highest_degree_of_education": {
                "school": [
                    {
                        "lang": "zh-CN",
                        "value": "张三"
                    }
                ],
                "level_of_education": {
                    "enum_name": "type_1",
                    "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": "type_1",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "school_name": {
                    "enum_name": "type_1",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "field_of_study_name": {
                    "enum_name": "type_1",
                    "display": [
                        {
                            "lang": "zh-CN",
                            "value": "张三"
                        }
                    ]
                },
                "country_region_id": "1",
                "expected_end_date": "2011-09-01",
                "custom_fields": [
                    {
                        "field_name": "name",
                        "value": "\"Sandy\""
                    }
                ]
            },
            "personal_profile": [
                {
                    "personal_profile_id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200",
                    "personal_profile_type": {
                        "enum_name": "type_1",
                        "display": [
                            {
                                "lang": "zh-CN",
                                "value": "张三"
                            }
                        ]
                    },
                    "files": [
                        {
                            "id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
                        }
                    ]
                }
            ]
        }
    }
}

事件

工作空间枚举

工作空间数据表

工作空间视图

角色

apiRef

内容

文件

文件夹

数据校验

表格操作

货币信息

地点 · 数据

事件

事件

审批 · 搜索

飞书原生审批

应用商店集成

第三方审批集成

更新个人信息 ​

请求 ​

请求头 ​

路径参数 ​

查询参数 ​

请求体 ​

请求体示例 ​

响应 ​

响应体 ​

响应体示例 ​

更新个人信息

请求

请求头

路径参数

查询参数

请求体

请求体示例

响应

响应体

响应体示例