Skip to content

查询单个个人信息

根据 ID 查询单个人员的个人信息。

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/corehr/v1/persons/:person_id
HTTP MethodGET
接口频率限制1000 次/分钟、50 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用 开启任一权限即可corehr:corehr:readonly 获取核心人事信息 corehr:person:read 获取员工个人信息 corehr:corehr 更新核心人事信息 corehr:person:write 读写员工的个人信息

请求头

名称类型必填描述
Authorizationstringtenant_access_token 值格式:"Bearer access_token" 示例值:"Bearer t-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
person_idstringPerson ID
示例值:"1616161616"

查询参数

名称类型必填描述
user_id_typestring用户 ID 类型
示例值:open_id
可选值有
- people_employee_id: 以people_employee_id来识别用户
默认值open_id

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ personperson个人信息
    └ phone_numberstring个人手机号
    └ legal_namestring法定姓名
    └ preferred_namestring常用名
    └ idstring实体在CoreHR内部的唯一键
    └ name_listperson_name\[\]姓名
      └ local_primarystring姓 - 本地文字
      └ local_first_namestring名 - 本地文字
      └ country_region_idstring国家 / 地区 ID
      └ name_typeenum姓名类型
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ local_first_name_2string名 - 第二本地文字
      └ local_primary_2string姓 - 第二本地文字
      └ additional_name_typeenum补充姓名类型
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ first_namestring
      └ full_namestring全名
      └ hereditarystring姓氏称谓
      └ middle_namestring中间名
      └ name_primarystring
      └ secondarystring第二姓氏
      └ socialenum尊称
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ tertiarystring婚后姓氏
      └ titleenum头衔
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ local_middle_namestring本地中间名
      └ local_secondarystring第二姓氏 - 本地文字
      └ display_name_local_and_western_scriptstring展示姓名(本地和西方文字)
      └ display_name_local_scriptstring展示姓名(本地文字)
      └ display_name_western_scriptstring展示姓名(西方文字)
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ genderenum性别
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言
        └ valuestring内容
    └ date_of_birthstring出生日期
    └ nationality_idstring国籍 ID
    └ raceenum民族 / 种族,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "person" - custom_api_name = "race"
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言
        └ valuestring内容
    └ marital_statusenum婚姻状况,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "person" - custom_api_name = "marital_status" 字段权限要求: 读写婚姻状况信息(corehr:person.marital_status:write)
      └ enum_namestring枚举值
      └ displayi18n\[\]枚举多语展示
        └ langstring语言
        └ valuestring内容
    └ phone_listphone\[\]电话列表
      └ international_area_codeenum国家区号,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "phone" - custom_api_name = "international_area_code"
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ phone_numberstring电话号码
      └ formatted_phone_numberstring完整电话号码
      └ device_typeenum设备类型,可选值如下: - mobile_phone:手机 - landline:座机 - fax:传真
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ phone_usageenum电话用途,可选值如下: - home:家庭 - work:工作 - emergency_contact:紧急联系人 - company:公司
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ is_primaryboolean主要电话
      └ is_publicboolean公开电话
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ address_listaddress\[\]地址列表
      └ full_address_local_scriptstring完整地址(本地文字)
      └ full_address_western_scriptstring完整地址(西方文字)
      └ idstring地址ID
      └ country_region_idstring国家 / 地区
      └ region_idstring主要行政区
      └ city_idstring城市
      └ distinct_idstring区/县
      └ local_address_line1string地址行 1(非拉丁语系的本地文字)
      └ local_address_line2string地址行 2(非拉丁语系的本地文字)
      └ local_address_line3string地址行 3(非拉丁语系的本地文字)
      └ local_address_line4string地址行 4(非拉丁语系的本地文字)
      └ local_address_line5string地址行 5(非拉丁语系的本地文字)
      └ local_address_line6string地址行 6(非拉丁语系的本地文字)
      └ local_address_line7string地址行 7(非拉丁语系的本地文字)
      └ local_address_line8string地址行 8(非拉丁语系的本地文字)
      └ local_address_line9string地址行 9(非拉丁语系的本地文字)
      └ postal_codestring邮政编码
      └ address_type_listenum\[\]地址类型
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ is_primaryboolean主要地址
      └ is_publicboolean公开地址
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ email_listemail\[\]邮件列表
      └ emailstring邮箱号
      └ is_primaryboolean主要邮箱
      └ is_publicboolean公开邮箱
      └ email_usageenum邮箱用途,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "email" - custom_api_name = "email_usage"
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ work_experience_listwork_experience\[\]工作履历
      └ company_organizationi18n\[\]公司 / 组织
        └ langstring语言
        └ valuestring内容
      └ departmenti18n\[\]部门
        └ langstring语言
        └ valuestring内容
      └ jobi18n\[\]岗位
        └ langstring语言
        └ valuestring内容
      └ descriptioni18n\[\]工作描述
        └ langstring语言
        └ valuestring内容
      └ start_datestring开始日期
      └ end_datestring结束日期
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ education_listeducation\[\]教育经历
      └ schooli18n\[\]学校
        └ langstring语言
        └ valuestring内容
      └ level_of_educationenum学历
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ start_datestring开始日期
      └ end_datestring结束日期
      └ field_of_studyi18n\[\]专业
        └ langstring语言
        └ valuestring内容
      └ degreeenum学位
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ school_nameenum学校名称
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ field_of_study_nameenum专业名称
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ country_region_idstring国家地区ID
      └ expected_end_datestring预期结束日期
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ bank_account_listbank_account\[\]银行账号
      └ bank_namestring银行名称
      └ bank_account_numberstring银行账号
      └ account_holderstring开户人姓名
      └ bankenum银行名称(该字段待作废,请勿使用)
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ branch_namestring支行名称
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ country_region_idstring国家/地区id,详细信息可通过【查询国家/地区信息】接口查询获得
      └ bank_account_usageenum\[\]银行卡用途,枚举值可通过文档【飞书人事枚举常量】银行卡用途(Bank Account Usage)枚举定义部分获得
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ bank_account_typeenum银行卡类型,枚举值可通过文档【飞书人事枚举常量】银行卡类型(Bank Account Type)枚举定义部分获得
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ currency_idstring货币id
    └ national_id_listnational_id\[\]证件号码
      └ national_id_type_idstring国家证件类型
      └ national_id_numberstring证件号码
      └ issue_datestring证件签发日期
      └ expiration_datestring证件到期日期
      └ country_region_idstring国家 / 地区
      └ issued_bystring证件签发机构
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ dependent_listdependent\[\]亲属
      └ nameperson_name姓名
        └ local_primarystring姓 - 本地文字
        └ local_first_namestring名 - 本地文字
        └ country_region_idstring国家 / 地区
        └ name_typeenum姓名类型
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ local_first_name_2string名 - 第二本地文字
        └ local_primary_2string姓 - 第二本地文字
        └ additional_name_typeenum补充姓名类型
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ first_namestring
        └ full_namestring全名
        └ hereditarystring姓氏称谓
        └ custom_namestring自定义姓名(未传入时,姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接)
        └ custom_local_namestring本地文字的自定义姓名(未传入时,本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接)
        └ middle_namestring中间名
        └ name_primarystring
        └ secondarystring第二姓氏
        └ socialenum尊称
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ tertiarystring婚后姓氏
        └ titleenum头衔
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ local_middle_namestring本地中间名
        └ local_secondarystring第二姓氏 - 本地文字
        └ display_name_local_and_western_scriptstring展示姓名(本地和西方文字)
        └ display_name_local_scriptstring展示姓名(本地文字)
        └ display_name_western_scriptstring展示姓名(西方文字)
        └ custom_fieldsobject_field_data\[\]自定义字段
          └ field_namestring字段名
          └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ relationshipenum关系
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ genderenum性别
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ date_of_birthstring生日
      └ nationality_idstring国籍 ID ,该字段已作废,请使用 nationality_id_v2 字段
      └ national_id_listnational_id\[\]证件号码
        └ national_id_type_idstring国家证件类型
        └ national_id_numberstring证件号码
        └ issue_datestring证件签发日期
        └ expiration_datestring证件到期日期
        └ country_region_idstring国家 / 地区
        └ issued_bystring证件签发机构
        └ custom_fieldsobject_field_data\[\]自定义字段
          └ field_namestring字段名
          └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ spouses_working_statusenum配偶工作状态
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ is_this_person_covered_by_health_insuranceboolean包含家属医疗保险
      └ is_this_person_allowed_for_tax_deductionboolean允许家属抵扣税款
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ dependent_namestring家庭成员姓名
      └ employerstring工作单位
      └ jobstring岗位
      └ phonephone电话
        └ international_area_codeenum国家区号,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "phone" - custom_api_name = "international_area_code"
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ phone_numberstring电话号码
        └ formatted_phone_numberstring完整电话号码
        └ device_typeenum设备类型,可选值如下: - mobile_phone:手机 - landline:座机 - fax:传真类型
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ phone_usageenum电话用途,可选值如下: - home:家庭 - work:工作 - emergency_contact:紧急联系人 - company:公司
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ is_primaryboolean主要电话
        └ is_publicboolean公开电话
        └ custom_fieldsobject_field_data\[\]自定义字段
          └ field_namestring字段名
          └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ addressaddress联系地址
        └ full_address_local_scriptstring完整地址(本地文字)
        └ full_address_western_scriptstring完整地址(西方文字)
        └ idstring地址ID
        └ country_region_idstring国家 / 地区
        └ region_idstring主要行政区
        └ city_idstring城市,该字段已作废,请使用 city_id_v2 字段
        └ distinct_idstring区/县,该字段已作废,请使用 district_id_v2 字段
        └ local_address_line1string地址行 1(非拉丁语系的本地文字)
        └ local_address_line2string地址行 2(非拉丁语系的本地文字)
        └ local_address_line3string地址行 3(非拉丁语系的本地文字)
        └ local_address_line4string地址行 4(非拉丁语系的本地文字)
        └ local_address_line5string地址行 5(非拉丁语系的本地文字)
        └ local_address_line6string地址行 6(非拉丁语系的本地文字)
        └ local_address_line7string地址行 7(非拉丁语系的本地文字)
        └ local_address_line8string地址行 8(非拉丁语系的本地文字)
        └ local_address_line9string地址行 9(非拉丁语系的本地文字)
        └ postal_codestring邮政编码
        └ address_type_listenum\[\]地址类型
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ is_primaryboolean主要地址
        └ is_publicboolean公开地址
        └ custom_fieldsobject_field_data\[\]自定义字段
          └ field_namestring字段名
          └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ birth_certificate_of_childfile\[\]出生证明
        └ idstring上传文件ID
    └ emergency_contact_listemergency_contact\[\]紧急联系人
      └ nameperson_name姓名
        └ local_primarystring姓 - 本地文字
        └ local_first_namestring名 - 本地文字
        └ country_region_idstring国家 / 地区
        └ name_typeenum姓名类型
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ local_first_name_2string名 - 第二本地文字
        └ local_primary_2string姓 - 第二本地文字
        └ additional_name_typeenum补充姓名类型
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ first_namestring
        └ full_namestring全名
        └ hereditarystring姓氏称谓
        └ custom_namestring自定义姓名(未传入时,姓名将默认根据所属国家 / 地区规则对相关姓、名字段拼接)
        └ custom_local_namestring本地文字的自定义姓名(未传入时,本地文字的姓名将默认根据所属国家 / 地区规则对本地文字的相关姓、名字段拼接)
        └ middle_namestring中间名
        └ name_primarystring
        └ secondarystring第二姓氏
        └ socialenum尊称
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ tertiarystring婚后姓氏
        └ titleenum头衔
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ local_middle_namestring本地中间名
        └ local_secondarystring第二姓氏 - 本地文字
        └ display_name_local_and_western_scriptstring展示姓名(本地和西方文字)
        └ display_name_local_scriptstring展示姓名(本地文字)
        └ display_name_western_scriptstring展示姓名(西方文字)
        └ custom_fieldsobject_field_data\[\]自定义字段
          └ field_namestring字段名
          └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ relationshipenum关系
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ phone_istphone\[\]电话
        └ international_area_codeenum国家区号,枚举值 api_name 可通过【获取字段详情】接口查询,查询参数如下: - object_api_name = "phone" - custom_api_name = "international_area_code"
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ phone_numberstring电话号码
        └ formatted_phone_numberstring完整电话号码
        └ device_typeenum设备类型,可选值如下: - mobile_phone:手机 - landline:座机 - fax:传真
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ phone_usageenum电话用途,可选值如下: - home:家庭 - work:工作 - emergency_contact:紧急联系人 - company:公司
          └ enum_namestring枚举值
          └ displayi18n\[\]枚举多语展示
            └ langstring语言
            └ valuestring内容
        └ is_primaryboolean主要电话
        └ is_publicboolean公开电话
        └ custom_fieldsobject_field_data\[\]自定义字段
          └ field_namestring字段名
          └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
      └ legal_namestring法定姓名
    └ date_entered_workforcestring参加工作日期
    └ profile_image_idstring头像资源的id
    └ custom_fieldsobject_field_data\[\]自定义字段
      └ field_namestring字段名
      └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ email_addressstring邮箱
    └ resident_tax_id_liststring\[\]纳税身份信息
    └ ageint年龄
    └ highest_level_of_educationeducation最高学历教育
      └ schooli18n\[\]学校
        └ langstring语言
        └ valuestring内容
      └ level_of_educationenum学历
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ start_datestring开始日期
      └ end_datestring结束日期
      └ field_of_studyi18n\[\]专业
        └ langstring语言
        └ valuestring内容
      └ degreeenum学位
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ school_nameenum学校名称
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ field_of_study_nameenum专业名称
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ country_region_idstring国家地区ID
      └ expected_end_datestring预期结束日期
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ highest_degree_of_educationeducation最高学位教育经历
      └ schooli18n\[\]学校
        └ langstring语言
        └ valuestring内容
      └ level_of_educationenum学历
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ start_datestring开始日期
      └ end_datestring结束日期
      └ field_of_studyi18n\[\]专业
        └ langstring语言
        └ valuestring内容
      └ degreeenum学位
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ school_nameenum学校名称
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ field_of_study_nameenum专业名称
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ country_region_idstring国家地区ID
      └ expected_end_datestring预期结束日期
      └ custom_fieldsobject_field_data\[\]自定义字段
        └ field_namestring字段名
        └ valuestring字段值,是json转义后的字符串,根据元数据定义不同,字段格式不同(123, 123.23, true, ["id1","id2], 2006-01-02 15:04:05])
    └ personal_profilepersonal_profile\[\]个人资料
      └ personal_profile_idstring个人资料 ID
      └ personal_profile_typeenum资料类型
        └ enum_namestring枚举值
        └ displayi18n\[\]枚举多语展示
          └ langstring语言
          └ valuestring内容
      └ filesfile\[\]上传文件列表
        └ idstring上传文件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"
                        }
                    ]
                }
            ]
        }
    }
}

内容来源:飞书开放平台 · 自动爬取整理