文档首页/ ISDP/ API参考/ API接口/ 数据分析/ 任务按时完成率(API名称:inTimeCompleteTask)
更新时间:2024-07-22 GMT+08:00
分享

任务按时完成率(API名称:inTimeCompleteTask)

功能介绍

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

相关API

接口名称

调用说明

获取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、分页数据

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

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档