文档首页/ ISDP/ API参考/ API接口/ 智能安监/ 标准化作业协同/ 按指令ID查询指令列表服务(API名称:findInstructions)
更新时间:2024-04-26 GMT+08:00
分享

按指令ID查询指令列表服务(API名称:findInstructions)

功能介绍

用于与客户系统对接按指令ID查询指令列表时需要用到的接口

相关接口

接口名称

调用说明

获取Token

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

URL

请求方式

HTTPS地址

服务架构

消息体类型

POST

https://isdp+域名/openapi/v1/openSceneTask/findInstructions

OpenAPI

application/json

请求头

KEY

VALUE

是否必填

描述

Content-Type

application/json

Authorization

bearer ${access_token}

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

请求参数

参数

类型

是否必填

描述

instructionIds

String

指令ID,多个通过英文逗号分隔,最多100个

响应参数

参数

类型

描述

result

Object

响应消息体

errorMessage

String

错误信息,接口错误时有值,正常调用时为空

stateCode

String

响应状态,“0”成功 其他值失败

result 对象出参说明

参数

类型

描述

instructionId

Long

指令ID

type

Int

指令类型:1-播报;2-播报+视频;3-播报+拍照;4-播报+录音;5-播报+直播

content

String

播报内容

status

Int

状态 1初始状态 2已完成 3超期

creationTimestamp

Long

指令创建时间

isdpDeviceList

Object

设备使用人集合

isdpDeviceList 对象出参说明

参数

类型

描述

isdpDeviceId

Long

设备id

请求示例

{
"instructionIds":"912"
}

响应示例

{
 "result": [
        {
            "content": "测试一下",
            "creationTimestamp": 1663141848000,
            "instructionId": 912,
            "isdpDeviceList": [
                {
                    "instructionId": 912,
                    "userId": 1823,
                    "userName": "张三"
                }
            ],
            "lastUpdateTimestamp": 1663141848000,
            "status": 1,
            "type": 1
        }
    ],
    "stateCode": "0"
}

状态码

状态码请参见状态码

错误码

错误码请参见错误码

相关文档