同步数据
接口说明: 上传计算平台分组数据。
请求方式:POST（HTTPS）
请求地址:https://api.xinrenxinshi.com/v5/calculation/group/syncdata
请求Header:
| key | value |
|---|---|
| access_token | 获取的access_token的实际值 |
Query参数:
| key | value |
|---|---|
| sign | 签名值 |
Body参数:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| platformGroupParamModel | PlatformGroupParamModel | Y | 请求参数model |
| timestamp | Long | Y | 请求时间戳（精确到毫秒） |
PlatformGroupParamModel
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| groupId | Integer | Y | 分组id |
| yearmo | Integer | Y | 年月 (例:202111) |
| syncKey | String | Y | 同步数据的key(必须是32位),说明 :当一次全量同步需要多次传输数据时 每批数据传入相同的synckey就会视为同一次全量操作，否则将删除原有全部数据进行全量操作 |
| data | LinkedList<LinkedHashMap<String, String>> | Y | 字段数据不能为空，list中每一个元素代表一行数据，map中k为字段id，v为字段的值,关联员工的字段必填.list最多一万条数据 |
返回结果:
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| errcode | Integer | Y | 0成功，其他失败 |
| errmsg | String | Y | 结果描述 |
| data | SyncResultDO | Y | 处理成功时的数据结果 |
SyncResultDO
| 参数 | 类型 | 必传(Y/N) | 说明 |
|---|---|---|---|
| isSuccess | Boolean | Y | 操作是否成功 |
| errors | List<String> | N | 错误内容 |
| errorType | Integer | N | 异常类型 1:操作异常 2:数据异常 |
请求示例(HTTPS):
https://api.xinrenxinshi.com/v5/calculation/group/syncdata?sign=7omyqoNIY5QPWKCyQM3Q7Hk8mNQ%3D
请求Body示例:
{
"groupId":1,
"yearmo":202111,
"syncKey":"10cdce5b52df4b8489d17c713e4d34d0",
"data":[
{
"5979820867bb406c8b843618488b006e":1,
"543b548bff0b45f7a047a9bc5a2f2f78":"张三"
}
],
"timestamp": 1606209415241
}
SDK请求示例(java):
CalculationSyncGroupV2Request request = new CalculationSyncGroupV2Request(access_token());
//需要同步数据的年月
request.setYearmo(202111);
// groupId为 group/list 接口中返回的groupId
request.setGroupId(1);
// syncKey 为 group/list 接口中返回的syncKey
request.setSyncKey("10cdce5b52df4b8489d17c713e4d34d0");
LinkedHashMap<String,String> map = new LinkedHashMap<>();
// map中的key为 group/list 接口中返回的fieldId，即字段id
map.put("543b548bff0b45f7a047a9bc5a2f2f78","张三");
// 手机号字段
map.put("543b548bff0b45f7a047a9bc5a2f2f71","19400000011");
LinkedHashMap<String,String> map1 = new LinkedHashMap<>();
// map中的key为 group/list 接口中返回的fieldId，即字段id
map1.put("543b548bff0b45f7a047a9bc5a2f2f78","李四");
map1.put("543b548bff0b45f7a047a9bc5a2f2f71","19400000012");
LinkedList<LinkedHashMap<String,String>> data = new LinkedList<>();
//员工1
data.add(map);
//员工2
data.add(map1);
//todo 添加更多员工
request.setData(data);
OpenapiResponse<CalculationSyncGroupDataResponse> response = XrxsCalculationService.syncGroupData(request);
响应示例:
{
"errcode":0,
"errmsg":"成功",
"data":{
"isSuccess":true,
"errors":[
],
"errorType":0
}
}