批量查询
接口说明: 一次查询多个员工的合同记录。包含合同信息、合同信息是否能编辑等信息;因为合同记录来源有多种,有些合同记录是不允许编辑更新的,例如:电子合同。
请求方式:GET(HTTPS)
请求地址:https://api.xinrenxinshi.com/v4/contract/list
请求Header:
key | value |
---|---|
access_token | 获取的access_token的实际值 |
参数说明:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeIds | String | Y | 员工id,多个逗号分隔,员工id个数限制在1~100之间 |
timestamp | Long | Y | 请求时间戳(精确到毫秒) |
sign | String | Y | 请求参数签名 |
返回结果:
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
errcode | Integer | Y | 0成功,其他失败 |
errmsg | String | Y | 结果描述 |
data | List<EmployeeFiledData> | N | 操作成功时返回 |
EmployeeFiledData
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
employeeId | String | Y | 员工ID |
firstRecordId | String | Y | 首次合同记录ID |
mainRecordId | String | N | 主合同记录ID |
contractInfos | List<EmployeeFieldArray> | Y | 合同信息列表 |
EmployeeFieldArray
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
recordId | String | Y | 合同记录ID |
editAble | Integer | Y | 0不可更新,1可更新 |
employeeFields | List<EmployeeField> | Y | 合同字段信息 |
EmployeeField
参数 | 类型 | 必传(Y/N) | 说明 |
---|---|---|---|
fieldId | String | Y | 字段ID |
fieldValue | String | Y | 字段值 |
结果样例:
{
"errcode": 0,
"errmsg": "成功",
"data": [
{
"employeeId": "employeeId",
"firstRecordId":"首次合同记录ID",
"mainRecordId":"主合同记录ID",
"contractInfos": [
{
"recordId": "recordId",
"employeeFields": [
{
"fieldId": "fieldId",
"fieldValue": "fieldValue"
}
]
}
]
}
]
}