- iThings-apisvr
- 物联网相关接口
- 产品
- 设备
- 设备分组
- 规则引擎
- ota升级
- 运维
- 系统管理
获取设备列表
POST
/api/v1/things/device/info/index
iThings-apisvr/物联网相关接口/设备/设备管理
请求参数
Authorization
在 Header 添加参数
Authorization
,其值为在 Basic 之后拼接空格,以及经过 Base64 编码的 username:password
示例:
Authorization: Basic *****************
Header 参数
iThings-token
string
可选
示例值:
eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzY2MjUyMTY2OTI5NjEyODAwIiwiUm9sZSI6NSwiSXNBbGxEYXRhIjoyLCJleHAiOjE2ODY4NDUxNDMsImlhdCI6MTY4NjgzOTM0MH0.cLlYLt7KLNPaZu1zPy49h1nsr7QaMfGkj5CIx1aIQqQ
iThings-project-id
string
可选
示例值:
1764800777801494528
Body 参数application/json
page
object
可选
page
integer
页码
size
integer
每页大小
projectIDs
array[string]
项目IDs
areaIDs
array[string]
区域IDs
productID
string
产品id
deviceName
string
过滤条件:模糊查询 设备名
deviceAlias
string
可选
position
object
可选
longitude
integer
经度
latitude
integer
维度
range
integer
可选
tags
array [object {2}]
key tag过滤查询
key
string
必需
value
string
必需
withProperties
array[string]
获取设备最新属性
示例
{
"projectIDs": [
"1764806234122309632"
],
"areaIDs": [
"1764914477426388992"
]
}
示例代码
Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'http://42.193.250.251:7777/api/v1/things/device/info/index' \
--header 'iThings-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJVaWQiOiIxNzY2MjUyMTY2OTI5NjEyODAwIiwiUm9sZSI6NSwiSXNBbGxEYXRhIjoyLCJleHAiOjE2ODcwMTUyMDYsImlhdCI6MTY4NzAwOTMxMn0.xxFiBpYlTIDLYhN-_stlrmYGOLqF-wHJKBSqs-zVb8k' \
--header 'iThings-project-id: 123123123' \
--header 'Content-Type: application/json' \
--header 'Authorization: Basic Og==' \
--data-raw '{
"projectIDs": [
"1764806234122309632"
],
"areaIDs": [
"1764914477426388992"
]
}'
返回响应
🟢200成功
application/json
Body
code
integer
必需
msg
string
必需
data
object
必需
list
array[object (设备信息) {21}]
必需
total
integer
必需
num
integer
必需
示例
{
"code": 200,
"msg": "success",
"data": {
"list": [
{
"productID": "24zjcQTJW8w",
"deviceName": "test5",
"createdTime": "1661438405",
"secret": "q7ThVsWki/BWWXKLGiIqezU0fsI=",
"firstLogin": "0",
"lastLogin": "0",
"version": "",
"logLevel": 1,
"cert": "",
"tags": null,
"isOnline": 1
},
{
"productID": "24zjcQTJW8w",
"deviceName": "test1",
"createdTime": "1661438413",
"secret": "QT82I8S+6+4HOAuAX2LhnxFMBXE=",
"firstLogin": "0",
"lastLogin": "0",
"version": "",
"logLevel": 1,
"cert": "",
"tags": null,
"isOnline": 1
},
{
"productID": "24zjcQTJW8w",
"deviceName": "test2",
"createdTime": "1661438416",
"secret": "q1YxFo/Jlsr3j6E8loWtkqynGG4=",
"firstLogin": "0",
"lastLogin": "0",
"version": "",
"logLevel": 1,
"cert": "",
"tags": null,
"isOnline": 1
},
{
"productID": "24zjcQTJW8w",
"deviceName": "test3",
"createdTime": "1661438419",
"secret": "46MAWbLKgY/KMiL47Aczn9kh8cI=",
"firstLogin": "0",
"lastLogin": "0",
"version": "",
"logLevel": 1,
"cert": "",
"tags": null,
"isOnline": 1
},
{
"productID": "24zjcCnIjss",
"deviceName": "test3",
"createdTime": "1661438432",
"secret": "fzbiivE1XisCbUERtM5hF0bx26Q=",
"firstLogin": "0",
"lastLogin": "0",
"version": "",
"logLevel": 1,
"cert": "",
"tags": null,
"isOnline": 1
},
{
"productID": "24zjcCnIjss",
"deviceName": "test1",
"createdTime": "1661438435",
"secret": "3XsWXU4svWh6QXjufcy76TZ+olE=",
"firstLogin": "0",
"lastLogin": "0",
"version": "",
"logLevel": 1,
"cert": "",
"tags": null,
"isOnline": 1
},
{
"productID": "24zjcCnIjss",
"deviceName": "test5",
"createdTime": "1661438440",
"secret": "dBqGvk2Lp9EZkg1vTaaRTElOaAo=",
"firstLogin": "0",
"lastLogin": "0",
"version": "",
"logLevel": 1,
"cert": "",
"tags": [
{
"key": "tag1",
"value": "tagval"
},
{
"key": "tag2",
"value": "tagval2"
}
],
"isOnline": 1
}
],
"total": 7,
"num": 7
}
}
修改于 2023-06-18 13:44:36