文档首页/ ISDP/ API参考/ API接口/ 数据分析/ 查询指定设备的故障类型分布（API名称：deviceIssueType）
更新时间：2025-06-16 GMT+08:00
查看PDF
分享

查询指定设备的故障类型分布（API名称：deviceIssueType）

功能介绍

根据给定的作业对象ID列表、开始时间、结束时间，统计每种问题类型的问题个数及占比。

只统计数量前三的类型，其他类型返回“其他故障”。

相关API

接口名称

调用说明

获取Token

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

调用流程

图1 查询指定设备的故障类型分布流程

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/productDevice/deviceIssueType

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

是

无

Authorization

bearer ${access_token}

是

bearer +“ ”+5.2.1中获取的access_token的值

请求参数

参数

类型

是否必填

描述

jobObjectIdList

List<String>

是

作业对象ID列表

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出参：

参数

类型

描述

issueType

String

问题类别

issueNum

Int

问题个数

rate

String

占比

code

String

编码

请求示例

{
    "jobObjectIdList": [0],
    "startDate": "2022-01-05",
    "endDate": "2022-12-31"
}

响应示例

{
    "stateCode": "0",
    "errorMessage": "成功",
    "result": {
        "pos": 0,
        "totalCount": 1,
        "data": [
            {
                "issueType": "其他故障:",
                "code": null,
                "rate": 0,
                "issueNum": 0
            }
        ],
        "header": null
    }
}

状态码

状态码请参见状态码。

错误码

错误码请参见错误码。

父主题： 数据分析

相关文档