查询场景或领域的任务数量(API名称:queryCategoryCount)
功能介绍
按照任务状态、区域ID、作业对象ID、作业对象名称、作业对象编码、作业类型名称、领域统计领域或场景的类型和父任务数量,并按时间显示。
不传领域,返回领域的类型和父任务数量;传领域,返回场景的类型和父任务数量。
相关API
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token,再调用其他接口时,需要在请求消息头中添加“Authorization”,其值即为Token。 |
调用流程
URL
|
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://isdp+域名/openapi/v1/dataOpen/queryCategoryCount |
OpenAPI |
application/json |
请求头
|
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
|
Content-Type |
application/json |
是 |
无 |
|
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
taskStatus |
Int |
是 |
任务状态:
|
|
regionId |
Int |
否 |
区域ID |
|
signSiteId |
Int |
否 |
作业对象ID |
|
signSiteName |
String |
否 |
作业对象名称 |
|
signSiteCode |
String |
否 |
作业对象编码 |
|
signSiteType |
String |
否 |
作业对象类型 |
|
parentCategory |
String |
否 |
一级任务类别名称(领域)
说明:
不传则统计领域,传领域统计场景。 |
|
dateList |
List<Object> |
是 |
时间区间列表
说明:
最多传6组,超过6组只返回前6组。 |
|
startDate |
String |
是 |
开始时间,格式yyyy-MM-dd |
|
endDate |
String |
是 |
结束时间,格式yyyy-MM-dd |
响应参数
|
参数 |
类型 |
描述 |
|---|---|---|
|
stateCode |
String |
响应状态码:
|
|
errorMessage |
String |
响应描述 |
|
result |
Object |
响应结果内容data、分页数据 |
result出参:
|
参数 |
类型 |
描述 |
|---|---|---|
|
pos |
int |
当前页,从0开始 |
|
total_count |
int |
总数量 |
|
data |
List<Object> |
响应结果内容data |
data出参:
|
参数 |
类型 |
描述 |
|---|---|---|
|
startDate |
String |
起始时间 |
|
endDate |
String |
结束时间 |
|
categoryCount |
List<Object> |
场景统计 |
|
parentCategoryCount |
List<Object> |
领域统计 |
categoryCount出参:
|
参数 |
类型 |
描述 |
|---|---|---|
|
category |
String |
二级任务类别名称(场景) |
|
count |
Int |
数量 |
parentCategoryCount出参:
|
参数 |
类型 |
描述 |
|---|---|---|
|
parentCategory |
String |
一级任务类别名称(领域) |
|
count |
Int |
数量 |
请求示例
{
"taskStatus": 2,
"signSiteId": 160016733,
"signSiteName": "极I低端换流变8212B换流变B相",
"signSiteCode": "8212B-GD-B",
"parentCategory": "倒闸操作",
"dateList": [
{
"startDate": "2022-09-26",
"endDate": "2022-10-02"
},
{
"startDate": "2022-10-03",
"endDate": "2022-10-09"
},
{
"startDate": "2022-10-10",
"endDate": "2022-10-16"
}
]
}
响应示例
{
"stateCode": "0",
"errorMessage": "成功",
"result": {
"pos": 0,
"totalCount": 3,
"data": [
{
"endDate": "2022-10-02",
"categoryCount": [],
"startDate": "2022-09-26"
},
{
"endDate": "2022-10-09",
"categoryCount": [],
"startDate": "2022-10-03"
},
{
"endDate": "2022-10-16",
"categoryCount": [
{
"category": "倒闸操作",
"count": 1
}
],
"startDate": "2022-10-10"
}
],
"header": null
}
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。