员工固定分组信息字段查询
接口说明: 用于获取分组信息对应的字段信息,包含字段ID、字段名称、是否必须字段、下拉列表字段信息等信息。主要是用于后面员工分组字段信息的 添加或者更新。
请求方式:POST(HTTPS)
请求地址:https://api.xinrenxinshi.com/v5/employee/group/fields
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
Query参数:
key | value |
---|---|
sign | 签名值 |
Body参数:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
groupType | String | Y | 分组类型,1-合同记录,5-兼职信息,7-教育经历,8-工作经历,9-培训经历,10-证书记录,11-联系人记录, |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | List<EmployeeGroupField> | N | 成功时返回,字段信息列表 |
EmployeeGroupField
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
fieldId | String | Y | 字段唯一ID |
labelName | String | Y | 字段页面展示文案 |
required | Boolean | Y | 添加分组信息时是否必传字段,true-必传,false-非必传 |
datasource | List<Map<String,String>> | N | 选项数据列表,map的key为添加或更新时入参的选项取值,map的value为对应的页面展示值 |
type | Integer | Y | 是否是自定义字段,0否1是 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/employee/group/fields?sign=o0BvsXtuFqrXtt%2FzVvAYHIB9u6o%3D
请求Body示例:
{
"groupType": 7,
"timestamp": 1606204375457
}
SDK请求示例(java):
EmployeeGroupFieldRequest request = new EmployeeGroupFieldRequest(access_token);
request.setGroupType(EmpGroupEnum.EDU_EXPERIENCE);
OpenapiResponse<List<EmployeeGroupField>> fields = XrxsEmployeeService.employeeGroupFieldList(request)
响应示例:
{
"errcode": 0,
"errmsg": "成功",
"data": [
{
"fieldId": "990b6664233d11ebb1810242c0a8100a",
"datasource": [],
"labelName": "教育序号",
"required": false
},
{
"fieldId": "990b7f7f233d11ebb1810242c0a8100a",
"datasource": [],
"labelName": "毕业院校",
"required": true
},
{
"fieldId": "990b9752233d11ebb1810242c0a8100a",
"datasource": [],
"labelName": "专业",
"required": true
},
{
"fieldId": "990bb073233d11ebb1810242c0a8100a",
"datasource": [
{
"value": "请选择",
"key": "0"
},
{
"value": "小学",
"key": "9"
},
{
"value": "初中",
"key": "1"
},
{
"value": "中专",
"key": "3"
},
{
"value": "中职",
"key": "10"
},
{
"value": "中技",
"key": "11"
},
{
"value": "高中",
"key": "2"
},
{
"value": "大专",
"key": "4"
},
{
"value": "本科",
"key": "5"
},
{
"value": "硕士",
"key": "6"
},
{
"value": "博士",
"key": "7"
},
{
"value": "其他",
"key": "8"
}
],
"labelName": "学历",
"required": true
},
{
"fieldId": "990bc9a0233d11ebb1810242c0a8100a",
"datasource": [
{
"value": "请选择",
"key": "0"
},
{
"value": "统招全日制",
"key": "1"
},
{
"value": "自考",
"key": "2"
},
{
"value": "成考",
"key": "3"
},
{
"value": "其他",
"key": "4"
}
],
"labelName": "教学方式",
"required": false
},
{
"fieldId": "990be262233d11ebb1810242c0a8100a",
"datasource": [],
"labelName": "入学时间",
"required": false
},
{
"fieldId": "990bfcf8233d11ebb1810242c0a8100a",
"datasource": [],
"labelName": "毕业时间",
"required": false
},
{
"fieldId": "990c1757233d11ebb1810242c0a8100a",
"datasource": [],
"labelName": "毕业证书",
"required": false
},
{
"fieldId": "990c2fcf233d11ebb1810242c0a8100a",
"datasource": [],
"labelName": "学位证书",
"required": false
},
{
"fieldId": "990c48cc233d11ebb1810242c0a8100a",
"datasource": [
{
"value": "是",
"key": "1"
},
{
"value": "否",
"key": "0"
}
],
"labelName": "是否最高学历",
"required": true
},
{
"fieldId": "990c6407233d11ebb1810242c0a8100a",
"datasource": [
{
"value": "是",
"key": "1"
},
{
"value": "否",
"key": "0"
}
],
"labelName": "第一学历",
"required": true
}
]
}