更新时间：2026-03-30 GMT+08:00
通过组织ID查询组织及所属组织下的设备列表（API名称：queryDeviceByOrgId）
功能介绍
通过组织ID查询组织及所属组织下的设备列表。
相关接口
|
接口名称 |
调用说明 |
|---|---|
|
调用该接口获取到Token，再调用其他接口时，需要在请求消息头中添加“Authorization”，其值即为Token。 |
URL
|
请求方式 |
HTTPS地址 |
服务架构 |
消息体类型 |
|---|---|---|---|
|
POST |
https://isdp+域名 /openapi/v1/helmet/queryDeviceByOrgId |
请求头
|
KEY |
VALUE |
是否必填 |
描述 |
|---|---|---|---|
|
Content-Type |
application/json |
是 |
无 |
|
Authorization |
bearer ${access_token} |
是 |
bearer +“ ”+5.2.1中获取的access_token的值 |
请求参数
|
参数 |
类型 |
是否必填 |
描述 |
|---|---|---|---|
|
orgId |
Long |
是 |
组织ID |
响应参数
|
参数 |
类型 |
描述 |
|---|---|---|
|
deviceId |
String |
设备ID |
|
isdpDeviceId |
String |
设备唯一标识 |
|
channelId |
Int |
通道Id |
|
deviceState |
String |
设备状态 |
|
buOrgId |
int |
组织ID |
|
orgPath |
String |
组织链路 |
请求示例
{
"orgId": 25245
}
响应示例
{
"resCode": "0",
"resMsg": "成功",
"result": {
"data": {
"data": [
{
"deviceNumber": 4,
"orgPath": "25245.98994512.98994513.98994514"
}
],
"error": null,
"message": "SUCCESS",
"status": 1,
"timestamp": "2025-12-29T19:53:25.780+0800"
},
"resCode": 0,
"resMess": "接口查询成功"
}
}
状态码
状态码请参见状态码。
错误码
错误码请参见错误码。
父主题： 设备管理
