任务按时完成率（API名称：inTimeCompleteTask）

功能介绍

该接口用于统计任务按时完成率数据。

接口名称	调用说明
获取Token	调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。

调用流程

图1 任务按时完成率流程
点击放大

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	响应状态码： 0-成功其他-失败
errorMessage	String	响应描述
result	Object	响应结果内容data、分页数据

参数

类型

描述

stateCode

String

响应状态码：

0-成功
其他-失败

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%"
                            }
                   ]
         }
}