文档首页/ ISDP/ API参考/ API接口/ 数据分析/ 查询场景或领域的任务数量（API名称：queryCategoryCount）
更新时间：2024-07-22 GMT+08:00
查看PDF
分享

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

功能介绍

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

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

相关API

接口名称

调用说明

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

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
    }
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 数据分析

相关文档