查询花名册字段信息

最后更新于:2020-07-29 14:59:29

接口描述

获取花名册元数据定义;传入metaDataCodes,返回对应模块的固定和动态字段

接口调用请求说明

https请求方式:GET

请求地址: https://openapi.ihr360.com/openapi/thirdparty/api/v1/staffs/metaDatas/{metaDataCodes}

metaDataCodes类型 备注
tab_staff_info 基础信息
tab_staff_job_history 工作经历
tab_staff_education 教育经历
tab_staff_certificate 员工证照
tab_staff_subset_ptd 个税申报

请求参数说明

调用前,在请求头信息中必须包含以下2项

Content-Type:application/json;charset=UTF-8

Authorization: Bearer access_token;

例如,获取到的有效凭证为8f87b9b1-9f66-4b32-9269-0d41a0face00,则头信息中数据应为:

Content-Type:application/json;charset=UTF-8

Authorization: Bearer 8f87b9b1-9f66-4b32-9269-0d41a0face00。

请求数据样例:

metaDataCodes 多个metaDataCode用逗号分隔  例:tab_staff_education,tab_staff_job_history

请求参数描述

参数 类型 是否必须 说明
metaDataCodes string 模块 多模块用,分隔 例:tab_staff_education,tab_staff_job_history

响应参数描述

参数 类型 说明
data JSONArray 拉取到的元数据列表
code String 返回码,成功为0
message String 返回信息
errorResult String 错误响应时,返回true, 反之则false

返回数据成功样例

{
    "code": 0,
    "message": "OK",
    "errorResult": false,
    "data":[{
             "metaId": "tab_staff_job_history",
             "displayName": "工作经历",
             "fieldList": [{
                              "columnName": "enrollDate",
                              "displayName": "入职日期",
                              "fieldType": "DATE",  // fieldType有以下几种类型:
                                                    //  BOOLEAN是否,INTEGER整数
                                                    //  DOUBLE小数,DATE日期
                                                    //  TIME小时分钟,DATETIME时间
                                                    //  CODE_TYPE选项,STRING文本
                                                    //  LONG_STRING长文本,IMG图片
                                                    //  FILE文件,CALCULATE计算项
                              "required": 1
                           },
                           {
                              "columnName": "companyName",
                              "displayName": "公司名称",
                              "fieldType": "STRING",
                              "required": 1
                           },
                           {
                              "columnName": "jobDescription",
                              "displayName": "职位描述",
                              "fieldType": "STRING",
                              "required": 0
                           }]
             }]
   }