ChainwayEMM
  1. 设备管理
ChainwayEMM
  • 注册令牌管理
    • 获取注册令牌
      GET
    • 修改注册令牌
      PATCH
  • 认证管理
    • 用户登录
      POST
    • 用户登出
      POST
    • 修改密码
      PATCH
    • 忘记密码
      POST
    • 重置密码
      POST
  • 设备管理
    • 获取设备列表
      GET
    • 获取设备详情
      GET
    • 修改设备信息
      PATCH
    • 获取设备事件
      GET
    • 批量删除设备
      DELETE
    • 发送设备命令
      POST
    • 批量更新设备组
      PATCH
  • 设备组管理
    • 获取设备组列表
      GET
    • 更新设备组信息
      PATCH
    • 创建设备组
      POST
    • 获取设备组详细信息
      GET
    • 删除设备组
      DELETE
    • 批量删除设备组
      DELETE
  • 策略管理
    • 获取当前企业下的所有策略
      GET
    • 创建策略
      POST
    • 获取策略详情
      GET
    • 删除策略
      DELETE
    • 更新策略
      PATCH
    • 批量删除策略
      DELETE
  • 管理员接口
    • 新用户注册流程第一步
    • 获取应用程序详情
    • 创建企业
    • 创建企业注册URL
    • 初始化企业资源
    • 获取所有企业列表
    • 获取指定企业下的所有注册令牌
    • 获取指定企业下的所有策略
    • 获取企业详情
    • 获取策略详情
    • 获取注册令牌详情
    • 创建注册令牌
    • 获取企业下所有设备
    • 删除企业下所有设备
    • 获取设备详细信息
    • 获取设备的策略详细信息
    • 向设备发送命令
  • 用户管理
    • 获取用户详情
    • 获取当前登录用户信息
    • 更新当前用户信息
  • 应用管理
    • 获取当前企业的品牌和型号信息
    • 获取当前企业的系统应用列表
    • 创建Web Token
    • 保存应用信息
    • 批量获取应用信息
    • 获取单个应用信息
  1. 设备管理

获取设备列表

GET
/devices
设备管理
获取当前企业下的设备列表,支持分页和关键字过滤

请求参数

Query 参数
deviceGroupId
integer <int64>
可选
设备组ID,0表示获取企业下所有设备
默认值:
0
current
integer <int64>
当前页码
可选
默认值:
1
size
integer <int64>
每页大小
可选
默认值:
20
keyword
string 
可选
关键字过滤条件,会在数据库层面匹配设备名称、IMEI号、设备型号、序列号,任意一个字段包含该关键字即会被包含在结果中
Header 参数
Authorization
string 
可选
默认值:
Bearer {{token}}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET '/devices' \
--header 'Authorization: Bearer {{token}}'

返回响应

🟢200成功
application/json
成功获取设备列表
Body
code
integer 
可选
示例值:
200
message
string 
可选
示例值:
获取设备列表成功
data
object 
可选
deviceList
array [object {11}] 
可选
total
integer 
设备总数
可选
size
integer 
每页大小
可选
current
integer 
当前页码
可选
pages
integer 
总页数
可选
hasNext
boolean 
是否有下一页
可选
hasPrevious
boolean 
是否有上一页
可选
示例
{
    "code": 200,
    "message": "获取设备列表成功",
    "data": {
        "deviceList": [
            {
                "id": 0,
                "name": "string",
                "deviceGroupId": 0,
                "policyId": 0,
                "imei": "string",
                "model": "string",
                "osVersion": "string",
                "serialNumber": "string",
                "lastCheckIn": "2019-08-24T14:15:22Z",
                "autoGroup": true,
                "state": "string"
            }
        ],
        "total": 0,
        "size": 0,
        "current": 0,
        "pages": 0,
        "hasNext": true,
        "hasPrevious": true
    }
}
🟠401没有权限
🟠403禁止访问
🟠404记录不存在
🔴500服务器错误
修改于 2025-06-20 08:40:00
上一页
重置密码
下一页
获取设备详情
Built with