# 创建个人信息
创建人员的个人信息。
**注意事项**：接口已升级，推荐使用：[创建个人信息](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/corehr-v2/person/create)
## 请求
基本 |
---|---
HTTP URL | https://open.feishu.cn/open-apis/corehr/v1/persons
HTTP Method | POST
接口频率限制 | [1000 次/分钟、50 次/秒](https://open.feishu.cn/document/ukTMukTMukTM/uUzN04SN3QjL1cDN)
支持的应用类型 | Custom App
权限要求
**调用该 API 所需的权限。开启其中任意一项权限即可调用**
开启任一权限即可 | 更新核心人事信息(corehr:corehr)
读写员工的个人信息(corehr:person: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 | 否 | 根据client_token是否一致来判断是否为同一请求
**示例值**：12454646
### 请求体
名称 | 类型 | 必填 | 描述
---|---|---|---
name_list | person_name\[\] | 是 | 姓名
local_primary | string | 否 | 姓 - 本地文字
**示例值**："黄"
local_first_name | string | 否 | 名 - 本地文字
**示例值**："四"
country_region_id | string | 是 | 国家 / 地区
**示例值**："6862995757234914824"
name_type | enum | 是 | 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（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 | 否 | 性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义部分获得
enum_name | string | 是 | 枚举值
**示例值**："type_1"
date_of_birth | string | 否 | 出生日期
**示例值**："2020-01-01"
nationality_id | string | 否 | 国籍id
**示例值**："123456789"
race | enum | 否 | 民族 / 种族，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)民族（race）枚举定义部分获得
enum_name | string | 是 | 枚举值
**示例值**："type_1"
marital_status | enum | 否 | 婚姻状况，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)婚姻状况（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 | 否 | 设备类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)设备类型（device_type）枚举定义部分获得
enum_name | string | 是 | 枚举值
**示例值**："type_1"
phone_usage | enum | 否 | 电话用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)电话用途（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 | 否 | 学历，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学历（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 | 否 | 学位，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学位（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\[\] | 否 | 银行卡用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡用途（bank_account_usage）枚举定义部分获得
enum_name | string | 是 | 枚举值
**示例值**："type_1"
bank_account_type | enum | 否 | 银行卡类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡类型（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 | 是 | 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（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 | 是 | 亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（relationship）枚举定义获得
enum_name | string | 是 | 枚举值
**示例值**："type_1"
gender | enum | 否 | 亲属性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（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 | 是 | 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（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 | 否 | 紧急联系人与本人亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（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 | 创建成功返回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 | 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（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 | 性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（gender）枚举定义部分获得
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 名称信息的语言
value | string | 名称信息的内容
date_of_birth | string | 出生日期
nationality_id | string | 国籍id
race | enum | 民族 / 种族，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)民族（race）枚举定义部分获得
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 名称信息的语言
value | string | 名称信息的内容
marital_status | enum | 婚姻状况，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)婚姻状况（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 | 设备类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)设备类型（device_type）枚举定义部分获得
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 名称信息的语言
value | string | 名称信息的内容
phone_usage | enum | 电话用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)电话用途（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 | 学历，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学历（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 | 学位，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学位（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\[\] | 银行卡用途，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡用途（bank_account_usage）枚举定义部分获得
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 名称信息的语言
value | string | 名称信息的内容
bank_account_type | enum | 银行卡类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)银行卡类型（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 | 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（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 | 亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（relationship）枚举定义获得
enum_name | string | 枚举值
display | i18n\[\] | 枚举多语展示
lang | string | 名称信息的语言
value | string | 名称信息的内容
gender | enum | 亲属性别，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)性别（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 | 姓名类型，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)姓名类型（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 | 紧急联系人与本人亲属关系，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)亲属关系（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 | 电话号码
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 | 学历，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学历（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 | 学位，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学位（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 | 学历，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学历（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 | 学位，枚举值可通过文档[【飞书人事枚举常量】](https://open.feishu.cn/document/uAjLw4CM/ukTMukTMukTM/reference/corehr-v1/feishu-people-enum-constant)学位（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",
"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"
}
]
}
]
}
}
}
```
### 错误码
HTTP状态码 | 错误码 | 描述 | 排查建议
---|---|---|---
500 | 1164001 | Internal error in transaction module | Please check direct manager
400 | 1164002 | Update or delete operation needs IDList | Please check dotted manager
400 | 1164003 | Action is invalid | Please check effective date
400 | 1164004 | Action affected rows exceed threshold value | 影响的数据超过上限，请检查传入参数
400 | 1164005 | Tenant or operator not found | 数据对象不合法，请检查传入参数
400 | 1164006 | Update Action contains invalid ID | 操作的数据ID无效，请检查传入参数
400 | 1164007 | Action count exceeds threshold | 操作的数据条数超上限，请检查传入参数
400 | 1164008 | Record lock retrieval failed | 数据库操作失败，请检查传入参数或重试
400 | 1164009 | Field lock retrieval missing RecordID | 获取字段锁缺失参数RecordID，请检查传入参数
400 | 1164010 | Field lock retrieval failed | 字段锁获取失败，请检查传入参数
400 | 1164011 | Field lock retrieval missing FieldName | 获取字段锁缺失参数FieldName,请检查传入参数
400 | 1164012 | Operation assigned invalid fields | 操作的字段不合法，请检查传入参数
400 | 1164013 | Assigned ID but has no active time | 缺失字段active time，请检查传入参数
400 | 1164014 | Object ApiName has more than one action | 对ApiName的操作多于一个，请检查传入参数
400 | 1164101 | Timeline penetration calculation failed | 时间线计算错误，请检查传入参数
400 | 1164102 | Timeline effective time format invalid | 时间线生效时间参数不合法，请检查传入参数
400 | 1164103 | Timeline effective time should be later than first effective time | 时间线生效时间应晚于第一次生效时间，请检查传入参数
400 | 1164104 | No corresponding timeline record | 未找到对应的时间线记录，请检查传入参数
400 | 1164105 | Duplicated effective timeline record | 时间线生效时间相同的记录重复，请检查传入参数
400 | 1164106 | Timeline Update action invalid | 更新时间线操作不合法，请检查传入参数
400 | 1164107 | Timeline action affected rows exceed threshold value | 时间线更新操作影响的记录数超过上限，请检查传入参数
400 | 1164108 | Timeline invalidation action invalid | 时间线操作不合法，请检查传入参数
400 | 1164109 | Timeline action count exceeds threshold | 时间线操作影响的记录超上限，请检查传入参数
400 | 1164110 | Timeline object contains no StartTime or EndTime | 时间线记录缺失StartTime或EndTime，请检查传入参数
400 | 1164111 | Timeline object cannot find corresponding version | 对应版本的时间线记录未找到，请检查传入参数
400 | 1164112 | Create timeline object with record id duplicated | 创建的时间线对象的ID重复，请检查传入参数
400 | 1164113 | Timeline object contains no inner control fields wk_status or wk_tid | 时间线记录缺乏对应的字段wk_status或wk_tid，请检查传入参数
400 | 1164114 | Timeline update used duplicated Version ID | 更新时间线时VersionID重复，请检查传入参数
400 | 1164115 | Timeline versionID is not integer type | 时间线记录的VersionID不是合法的整数，请检查传入参数
400 | 1164116 | Timeline versionID type invalid | 时间线VersionID数据类型不合法，请检查传入参数
400 | 1164117 | Timeline version query request invalid | 时间线版本查询参数不合法，请检查传入参数
400 | 1164118 | Timeline version info contains no effective time | 时间线版本信息缺失生效时间，请检查传入参数
400 | 1164119 | Timeline first version cannot be corrected later than second version | 时间线第一个版本不能晚于后续版本，请检查传入参数
400 | 1164120 | Timeline version ID not exist | 时间线VersionID不存在，请检查传入参数
400 | 1164121 | Timeline first version cannot be invalidated | 时间线VersionID不合法，请检查传入参数
400 | 1164122 | Timeline field uniqueness violation | 时间线对象唯一性校验不通过，请检查传入参数
400 | 1164123 | Timeline update target is inactivated | 更新的时间线对象已失效，请检查传入参数
400 | 1164124 | The effective time of the first version cannot be a future moment | 第一个版本的生效时间不能晚于当前时间，请检查传入参数
400 | 1164125 | Timeline version's corresponding record does not exist | 时间线版本对应的记录不存在，请检查传入参数
400 | 1164126 | Timeline create versionID does not exist when converting to correct | 时间线VersionID不合法，请检查传入参数
400 | 1164127 | Timeline record is under reconstructing | 时间线记录创建中，请检查传入参数
400 | 1164128 | Timeline record reconstruct unlock failed | 时间线记录解锁失败，请检查传入参数
400 | 1164129 | Timeline version ID has already been invalidated | 时间线VersionID不合法，请检查传入参数
400 | 1164130 | Timeline create at should be later than first create at | 时间线创建时间不合法，请检查传入参数
400 | 1164201 | Timeline multi record effective time conflicted | 多条时间线记录生效时间冲突，请检查传入参数
400 | 1164202 | Timeline multi record has duplicated time range | 多条时间线记录的时间区间冲突，请检查传入参数
400 | 1164203 | Timeline multi record has no start time defined | 时间线记录缺失开始时间，请检查传入参数
400 | 1164204 | Timeline multi record has no biz group field defined | 时间线记录的字段Group未定义，请检查传入参数
400 | 1164205 | Timeline multi record update scenario lacking time field | 时间线更新场景缺失时间，请检查传入参数
400 | 1164206 | At the same effective time, the timeline field is updated repeatedly | 时间线生效时间重复，请检查传入参数
400 | 1164207 | Timeline multi record end time less than effective time | 时间线结束时间晚于生效时间，请检查传入参数
400 | 1164301 | Request param is invalid, pls check | 请求参数不合法，请检查传入参数
400 | 1164302 | Timeline record does not contain time information | 时间线记录缺失时间信息，请检查传入参数
400 | 1164401 | LookUp field is not a multi-LookUp | 查找的字段不合法，请检查传入参数
400 | 1164402 | LookUp field is not a single-LookUp | 查找的字段不合法，请检查传入参数
400 | 1164403 | The record corresponding to the lookup field value does not exist | 被查询的记录不存在，请检查传入参数
400 | 1164404 | LookUp field value query failed | 查询字段失败，请检查传入参数
400 | 1164405 | LookUp field value type incorrect | 查询字段的类型不正确，请检查传入参数
400 | 1164406 | Boolean type field type error | 传入的Boolean类型字段不合法，请检查传入参数
400 | 1164407 | Text type field is not i18n | Text类型的字段不是i18N类型，请检查传入参数
400 | 1164408 | Text type field value exceeds maximum length | Text类型的字段长度超限，请检查传入参数
400 | 1164409 | Text type field is not string | Text类型字段不是字符串，请检查传入参数
400 | 1164410 | The format for i18n error | 类型转换为i18n时失败，请检查传入参数
400 | 1164411 | The content for i18n error | i18n类型的内容不合法，请检查传入参数
400 | 1164412 | Enum fields type errors | 枚举类型错误，请检查传入参数
400 | 1164413 | The number of digits is too long | 数字字段长度超限，请检查传入参数
400 | 1164414 | Datetime field type error | DateTime字段不合法，请检查传入参数
400 | 1164415 | Datetime field time type error | DateTime字段的时间不合法，请检查传入参数
400 | 1164416 | Datetime field date type error | DateTime字段的日期不合法，请检查传入参数
400 | 1164417 | Image field type error | 图片类型字段不合法，请检查传入参数
400 | 1164418 | The fileID of the image field does not exist | FileID对应的图片不存在，请检查传入参数
400 | 1164419 | The fileID of the attachment field does not exist | FileID对应的附件不存在，请检查传入参数
400 | 1164420 | Attachment field type error | 附件类型字段不合法，请检查传入参数
400 | 1164421 | Required field not included | 缺乏必须的参数，请检查传入参数
400 | 1164422 | The value of the Required field is null. | 缺乏必须的参数，请检查传入参数
400 | 1164423 | Number field int or float type error | 数字类型字段不合法，请检查传入参数
400 | 1164424 | Decimal out of range | 浮点数越界，请检查传入参数
400 | 1164425 | Value out of range | 数据类型越界，请检查传入参数
400 | 1164426 | Enum should be single not multiple error | 枚举字段传入了多个，请检查传入参数
400 | 1164427 | Enum should be multiple not single error | 枚举字段传入了单个，请检查传入参数
400 | 1164428 | Enum value not exist | 枚举值不存在，请检查传入参数
400 | 1164429 | AutoNumber field type error | AutoNumber字段不合法，请检查传入参数
400 | 1164430 | Datetime field string formatting Error | 字符串转Datetime失败，请检查传入参数
400 | 1164431 | Attachment type field single value parsing failed | 附件类型参数不合法，请检查传入参数
400 | 1164432 | Attachment type field multiple value parsing failed | 附件类型参数不合法，请检查传入参数
400 | 1164433 | Filename extension error | 文件后缀错误，请检查传入参数
400 | 1164434 | Image field should include multiple values | 图片字段应包含多个值，请检查传入参数
400 | 1164435 | The lookup field contains duplicate keys | 查询的字段Key重复，请检查传入参数
400 | 1164436 | Required fields are empty | 缺乏必填字段，请检查传入参数
400 | 1164437 | Illegal back lookup | 查询参数错误，请检查传入参数
400 | 1164438 | Date field string formatting Error | 字符串转Date失败，请检查传入参数
400 | 1164439 | Time field string formatting Error | 字符串转Time失败，请检查传入参数
400 | 1164440 | Invalid time format | 时间参数不合法，请检查传入参数
400 | 1164441 | duplicate biz group for mulVersion | mulVersion包含多个重复的Group，请检查传入参数
400 | 1164442 | action update out of order | 操作顺序不当，请检查传入参数
400 | 1164443 | unique value has been used | 唯一键冲突，请检查传入参数
400 | 1164444 | un sup unique field | 唯一键冲突，请检查传入参数
400 | 1164445 | can not update pair field | 更新字段错误，请检查传入参数
400 | 1164446 | can not update multistage field | 不能更新multistage字段，请检查传入参数
400 | 1164447 | can not only create paired object | 不能创建pair object，请检查传入参数
400 | 1164448 | pair field is null | Pair field缺失，请检查传入参数
400 | 1164449 | pair field must one on one | Pair field不合法，请检查传入参数
400 | 1164450 | cascade must have wk_id field | 字段wk_id缺失，请检查传入参数
400 | 1164501 | Unable to delete as it is still in use | 不可删除正在使用的记录，请检查传入参数