任务按时完成率(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%"
}
]
}
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。