查询场景或领域的任务数量（API名称：queryCategoryCount）

功能介绍

按照任务状态、区域ID、作业对象ID、作业对象名称、作业对象编码、作业类型名称、领域统计领域或场景的类型和父任务数量，并按时间显示。

不传领域，返回领域的类型和父任务数量；传领域，返回场景的类型和父任务数量。

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

调用流程

图1 查询场景或领域的任务数量流程
点击放大

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	是	任务状态： 0：草稿 1：待执行 2：执行中 3：已完成 4：已取消 5：申请待审批 9：已驳回
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	响应状态码： 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	结束时间
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
    }
}