查询单个个人信息
根据 ID 查询单个人员的个人信息。
请求
| 项目 | 值 |
|---|---|
| HTTP URL | https://open.feishu.cn/open-apis/corehr/v1/persons/:person_id |
| HTTP Method | GET |
| 接口频率限制 | 1000 次/分钟、50 次/秒 |
| 支持的应用类型 | custom,isv |
| 权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可 | corehr:corehr:readonly 获取核心人事信息 corehr:person:read 获取员工个人信息 corehr:corehr 更新核心人事信息 corehr:person:write 读写员工的个人信息 |
请求头
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
| Authorization | string | 是 | tenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token |
路径参数
| 名称 | 类型 | 描述 |
|---|---|---|
person_id | string | Person ID 示例值:"1616161616" |
查询参数
| 名称 | 类型 | 必填 | 描述 |
|---|---|---|---|
user_id_type | string | 否 | 用户 ID 类型 示例值:open_id 可选值有: - people_employee_id: 以people_employee_id来识别用户默认值: open_id |
响应
响应体
| 名称 | 类型 | 描述 |
|---|---|---|
code | int | 错误码,非 0 表示失败 |
msg | string | 错误描述 |
data | \- | - |
└ person | person | 个人信息 |
└ phone_number | string | 个人手机号 |
└ legal_name | string | 法定姓名 |
└ preferred_name | string | 常用名 |
└ id | string | 实体在CoreHR内部的唯一键 |
└ name_list | person_name\[\] | 姓名 |
└ local_primary | string | 姓 - 本地文字 |
└ local_first_name | string | 名 - 本地文字 |
└ country_region_id | string | 国家 / 地区 ID |
└ name_type | enum | 姓名类型 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ local_first_name_2 | string | 名 - 第二本地文字 |
└ local_primary_2 | string | 姓 - 第二本地文字 |
└ additional_name_type | enum | 补充姓名类型 |
└ 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 | 头衔 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ local_middle_name | string | 本地中间名 |
└ local_secondary | string | 第二姓氏 - 本地文字 |
└ display_name_local_and_western_script | string | 展示姓名(本地和西方文字) |
└ display_name_local_script | string | 展示姓名(本地文字) |
└ display_name_western_script | string | 展示姓名(西方文字) |
└ 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 | 性别 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ date_of_birth | string | 出生日期 |
└ nationality_id | string | 国籍 ID |
└ race | enum | 民族 / 种族,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "person" - custom_api_name = "race" |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ marital_status | enum | 婚姻状况,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "person" - custom_api_name = "marital_status" 字段权限要求: 读写婚姻状况信息(corehr:person.marital_status:write) |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ phone_list | phone\[\] | 电话列表 |
└ international_area_code | enum | 国家区号,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "phone" - custom_api_name = "international_area_code" |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ phone_number | string | 电话号码 |
└ formatted_phone_number | string | 完整电话号码 |
└ device_type | enum | 设备类型,可选值如下: - mobile_phone:手机 - landline:座机 - fax:传真 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ phone_usage | enum | 电话用途,可选值如下: - home:家庭 - work:工作 - emergency_contact:紧急联系人 - company:公司 |
└ 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 | 邮政编码 |
└ address_type_list | enum\[\] | 地址类型 |
└ 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]) |
└ email_list | email\[\] | 邮件列表 |
└ email | string | 邮箱号 |
└ is_primary | boolean | 主要邮箱 |
└ is_public | boolean | 公开邮箱 |
└ email_usage | enum | 邮箱用途,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "email" - custom_api_name = "email_usage" |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | 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 | 学历 |
└ 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 | 学位 |
└ 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 | 银行名称(该字段待作废,请勿使用) |
└ 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 | 姓名类型 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ local_first_name_2 | string | 名 - 第二本地文字 |
└ local_primary_2 | string | 姓 - 第二本地文字 |
└ additional_name_type | enum | 补充姓名类型 |
└ 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 | 头衔 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ local_middle_name | string | 本地中间名 |
└ local_secondary | string | 第二姓氏 - 本地文字 |
└ display_name_local_and_western_script | string | 展示姓名(本地和西方文字) |
└ display_name_local_script | string | 展示姓名(本地文字) |
└ display_name_western_script | string | 展示姓名(西方文字) |
└ 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 | 关系 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ gender | enum | 性别 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ date_of_birth | string | 生日 |
└ nationality_id | string | 国籍 ID ,该字段已作废,请使用 nationality_id_v2 字段 |
└ 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 | 配偶工作状态 |
└ 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 | 国家区号,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "phone" - custom_api_name = "international_area_code" |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ phone_number | string | 电话号码 |
└ formatted_phone_number | string | 完整电话号码 |
└ device_type | enum | 设备类型,可选值如下: - mobile_phone:手机 - landline:座机 - fax:传真类型 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ phone_usage | enum | 电话用途,可选值如下: - home:家庭 - work:工作 - emergency_contact:紧急联系人 - company:公司 |
└ 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 | address | 联系地址 |
└ full_address_local_script | string | 完整地址(本地文字) |
└ full_address_western_script | string | 完整地址(西方文字) |
└ id | string | 地址ID |
└ country_region_id | string | 国家 / 地区 |
└ region_id | string | 主要行政区 |
└ city_id | string | 城市,该字段已作废,请使用 city_id_v2 字段 |
└ distinct_id | string | 区/县,该字段已作废,请使用 district_id_v2 字段 |
└ local_address_line1 | string | 地址行 1(非拉丁语系的本地文字) |
└ local_address_line2 | string | 地址行 2(非拉丁语系的本地文字) |
└ local_address_line3 | string | 地址行 3(非拉丁语系的本地文字) |
└ local_address_line4 | string | 地址行 4(非拉丁语系的本地文字) |
└ local_address_line5 | string | 地址行 5(非拉丁语系的本地文字) |
└ local_address_line6 | string | 地址行 6(非拉丁语系的本地文字) |
└ local_address_line7 | string | 地址行 7(非拉丁语系的本地文字) |
└ local_address_line8 | string | 地址行 8(非拉丁语系的本地文字) |
└ local_address_line9 | string | 地址行 9(非拉丁语系的本地文字) |
└ postal_code | string | 邮政编码 |
└ address_type_list | enum\[\] | 地址类型 |
└ 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]) |
└ 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 | 姓名类型 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ local_first_name_2 | string | 名 - 第二本地文字 |
└ local_primary_2 | string | 姓 - 第二本地文字 |
└ additional_name_type | enum | 补充姓名类型 |
└ 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 | 头衔 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ local_middle_name | string | 本地中间名 |
└ local_secondary | string | 第二姓氏 - 本地文字 |
└ display_name_local_and_western_script | string | 展示姓名(本地和西方文字) |
└ display_name_local_script | string | 展示姓名(本地文字) |
└ display_name_western_script | string | 展示姓名(西方文字) |
└ 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 | 关系 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ phone_ist | phone\[\] | 电话 |
└ international_area_code | enum | 国家区号,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "phone" - custom_api_name = "international_area_code" |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ phone_number | string | 电话号码 |
└ formatted_phone_number | string | 完整电话号码 |
└ device_type | enum | 设备类型,可选值如下: - mobile_phone:手机 - landline:座机 - fax:传真 |
└ enum_name | string | 枚举值 |
└ display | i18n\[\] | 枚举多语展示 |
└ lang | string | 语言 |
└ value | string | 内容 |
└ phone_usage | enum | 电话用途,可选值如下: - home:家庭 - work:工作 - emergency_contact:紧急联系人 - company:公司 |
└ 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]) |
└ 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 | 学历 |
└ 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 | 学位 |
└ 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 | 学历 |
└ 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 | 学位 |
└ 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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"local_first_name_2": "五",
"local_primary_2": "王",
"additional_name_type": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"first_name": "帅",
"full_name": "刘梓新",
"hereditary": "王",
"middle_name": "大",
"name_primary": "王",
"secondary": "王",
"social": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"tertiary": "王",
"title": {
"enum_name": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"date_of_birth": "2020-01-01",
"nationality_id": "7075702732803278381",
"race": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"marital_status": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"phone_list": [
{
"international_area_code": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"phone_number": "010-12345678",
"formatted_phone_number": "+86 010-12345678",
"device_type": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"phone_usage": {
"enum_name": "phone_type",
"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",
"address_type_list": [
{
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
}
],
"is_primary": true,
"is_public": true,
"custom_fields": [
{
"field_name": "name",
"value": "Sandy"
}
]
}
],
"email_list": [
{
"email": "12456@test.com",
"is_primary": true,
"is_public": true,
"email_usage": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"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": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"school_name": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"field_of_study_name": {
"enum_name": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"branch_name": "中国农业银行支行",
"custom_fields": [
{
"field_name": "name",
"value": "Sandy"
}
],
"country_region_id": "12",
"bank_account_usage": [
{
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
}
],
"bank_account_type": {
"enum_name": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"local_first_name_2": "五",
"local_primary_2": "王",
"additional_name_type": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"first_name": "帅",
"full_name": "刘梓新",
"hereditary": "王",
"custom_name": "刘梓新",
"custom_local_name": "刘梓新",
"middle_name": "大",
"name_primary": "王",
"secondary": "王",
"social": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"tertiary": "王",
"title": {
"enum_name": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"gender": {
"enum_name": "phone_type",
"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": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"phone_number": "010-12345678",
"formatted_phone_number": "+86 010-12345678",
"device_type": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"phone_usage": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"is_primary": true,
"is_public": true,
"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": "PoewH",
"local_address_line4": "jmwJc",
"local_address_line5": "jmwJc",
"local_address_line6": "jmwJc",
"local_address_line7": "jmwJc",
"local_address_line8": "rafSu",
"local_address_line9": "McPRG",
"postal_code": "611530",
"address_type_list": [
{
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
}
],
"is_primary": true,
"is_public": true,
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"local_first_name_2": "五",
"local_primary_2": "王",
"additional_name_type": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"first_name": "帅",
"full_name": "刘梓新",
"hereditary": "王",
"custom_name": "刘梓新",
"custom_local_name": "刘梓新",
"middle_name": "大",
"name_primary": "王",
"secondary": "王",
"social": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"tertiary": "王",
"title": {
"enum_name": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"phone_ist": [
{
"international_area_code": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"phone_number": "010-12345678",
"formatted_phone_number": "+86 010-12345678",
"device_type": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"phone_usage": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"is_primary": true,
"is_public": true,
"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": 22,
"highest_level_of_education": {
"school": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
],
"level_of_education": {
"enum_name": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"school_name": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"field_of_study_name": {
"enum_name": "phone_type",
"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": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"school_name": {
"enum_name": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"field_of_study_name": {
"enum_name": "phone_type",
"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": "phone_type",
"display": [
{
"lang": "zh-CN",
"value": "刘梓新"
}
]
},
"files": [
{
"id": "150018109586e8ea745e47ae8feb3722dbe1d03a181336393633393133303431393831343930373235150200"
}
]
}
]
}
}
}