任务按时完成率（API名称：inTimeCompleteTask）
功能介绍
该接口用于统计任务按时完成率数据。
相关API
接口名称 |
调用说明 |
|---|---|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
调用流程
URL
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
POST |
https://isdp+域名/openapi/v1/cardTask/inTimeCompleteTask |
OpenAPI |
application/json |
请求头
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
Content-Type |
application/json |
是 |
无 |
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
pageStart |
int |
否 |
当前页码，从0开始 |
pageSize |
int |
否 |
每页数量，默认15条，最多100条 |
date |
String |
必选 |
统计日期 |
dateType |
String |
必选 |
时间类型（day、week、month） |
period |
int |
必选 |
周期 |
sceneName |
String |
否 |
任务场景，支持模糊查询 |
orgIdList |
List<int> |
否 |
组织id列表，默认所有组织 |
响应参数
参数 |
类型 |
描述 |
|---|---|---|
stateCode |
String |
响应状态码：
|
errorMessage |
String |
响应描述 |
result |
Object |
响应结果内容data、分页数据 |
result出参：
参数 |
类型 |
描述 |
|---|---|---|
pos |
int |
当前页，从0开始 |
total_count |
int |
总数量 |
data |
List<Object> |
响应结果内容data |
data出参：
参数 |
类型 |
描述 |
|---|---|---|
startDate |
String |
开始日期 |
endDate |
String |
结束日期 |
index |
int |
序号 |
completeNum |
int |
已完成任务数 |
ontimeCompleteNum |
int |
按时完成任务数 |
ratio |
String |
按时完成率 |
请求示例
{
"date": "2022-06-11",
"dateType": "day",
"period": 7,
"sceneName": "巡检",
"orgIdList": ["123", "124"],
"pageStart": 0,
"pageSize": 15
}
响应示例
{
"stateCode": "0",
"errorMessage": "success",
"result": {
"pos": 0,
"totalCount": 2,
"data": [
{
"index": 0,
"startDate": "2022-06-06",
"endDate": "2022-06-11",
"completeNum": 18,
"ontimeCompleteNum": 22,
"ratio": "90%"
},
{
"index": 1,
"startDate": "2022-05-30",
"endDate": "2022-06-05",
"completeNum": 18,
"ontimeCompleteNum": 22,
"ratio": "80%"
}
]
}
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
