阅读量:0
queryBonusSumVal API用于按时间段查询人员总分,通过输入开始时间和结束时间,返回指定时间段内人员的奖金总和。
按时间段查询人员总分(API名称:queryBonusSumVal)
1. API概述
queryBonusSumVal
是一个用于查询指定时间段内人员总分的API,它可以根据用户输入的时间范围,返回该时间段内所有人员的奖金总和。
2. 请求参数
参数名 | 类型 | 必填 | 描述 |
startTime | String | 是 | 开始时间,格式为"YYYYMMDD HH:mm:ss" |
endTime | String | 是 | 结束时间,格式为"YYYYMMDD HH:mm:ss" |
userIDList | Array | 否 | 需要查询的人员ID列表,如果不提供,则查询所有人员 |
3. 返回结果
字段名 | 类型 | 描述 |
totalBonusSum | Number | 指定时间段内所有人员的奖金总和 |
userInfoList | Array | 包含每个人员的奖金信息,包括以下字段: userID:人员ID bonusSum:该人员在指定时间段内的奖金总和 |
4. 示例请求
curl X POST "http://api.example.com/queryBonusSumVal" H "ContentType: application/json" d '{ "startTime": "20220101 00:00:00", "endTime": "20220131 23:59:59", "userIDList": ["user1", "user2", "user3"] }'
5. 示例返回结果
{ "totalBonusSum": 10000, "userInfoList": [ { "userID": "user1", "bonusSum": 5000 }, { "userID": "user2", "bonusSum": 3000 }, { "userID": "user3", "bonusSum": 2000 } ] }