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

查询场景或领域的任务数量(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
    }
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档