# 查询场景或领域的任务数量（API名称：queryCategoryCount）
#### 功能介绍
按照任务状态、区域ID、作业对象ID、作业对象名称、作业对象编码、作业类型名称、领域统计领域或场景的类型和父任务数量，并按时间显示。
![](https://support.huaweicloud.com/api-isdp/public_sys-resources/note_3.0-zh-cn.png)
不传领域，返回领域的类型和父任务数量；传领域，返回场景的类型和父任务数量。
#### 相关API
| **接口名称**                                                             | **调用说明**                                                     |
|:---|:---|
| [获取Token](https://support.huaweicloud.com/api-isdp/api_01_0019.html) | 调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加"Authorization"，其值即为Token。 |
   
#### 调用流程
图1查询场景或领域的任务数量流程   
![](https://support.huaweicloud.com/api-isdp/zh-cn_image_0000002490814824.png "点击放大")
#### 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](https://support.huaweicloud.com/api-isdp/api_01_0019.html)中获取的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、分页数据                                                                                                                                                                                                                                                                                                                                                                              |
   
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
    }
}
```
#### 状态码
状态码请参见[状态码](https://support.huaweicloud.com/api-isdp/api_01_0326.html)。
#### 错误码
错误码请参见[错误码](https://support.huaweicloud.com/api-isdp/api_01_0327.html)。