向日葵开放API
贝锐企业+试用向日葵企业管理平台
贝锐企业+试用向日葵企业管理平台
  1. 企业子账号管理
  • 📃 简介
  • 🌐 管理平台API
    • 开发者必读
      • 流程概述
      • 接入准备
      • 平台签名校验
      • 用户身份校验
      • 错误码对照表
    • 用户身份授权API
      • 身份授权
      • 续租授权
    • 核心服务API
      • 设备信息管理
        • 创建/取消主机授权
        • 获取主机列表
        • 获取单个主机基本信息
        • 修改主机
        • 删除主机
        • 查询主机状态
      • 审计日志查询
        • 查询远程日志列表
        • 查询被控端(上下线)日志列表
        • 查询被控日志
        • 查询控制端最近登录日志
        • 查询文件传输日志
        • 查询操作日志
      • 资产信息查询
        • 查询IT资产列表
        • 根据资产ID查询是否有变更数据
        • 查询IT资产变更历史
      • 坐席服务管理
        • 新增坐席成员
        • 更新坐席成员
        • 查询坐席成员-列表
        • 删除坐席星标客户
        • 删除坐席成员
        • 强制下线-坐席成员
        • 查询坐席星标客户-列表
        • 查询坐席日志
      • 设备分组管理
        • 查询主机关联的分组
        • 创建主机与分组的关联
        • 创建分组
        • 删除主机与分组的关联
        • 修改分组
        • 删除分组
        • 查询分组的列表
      • 企业子账号管理
        • 子账号身份授权
          POST
        • 修改子账号信息
          PUT
        • 创建企业子账号
          POST
        • 删除企业子账号
          DELETE
        • 查询子账号列表
          GET
        • 获取指定子账号信息
          GET
        • 查询账号分组的功能模块列表
          GET
        • 修改指定的分组功能模块
          PUT
        • 获取角色分组列表
          GET
        • 新增角色分组
          POST
        • 更新角色分组
          PUT
        • 删除角色分组
          DELETE
        • 获取组织部门列表
          GET
        • 创建部门
          POST
        • 修改部门
          PUT
        • 删除部门
          DELETE
        • 获取功能模块列表
          GET
        • 修改企业账号密码
          PUT
    • 硬件API
      • 获取插座用电量
      • 开关插座
      • 获取插座状态
  • 💻 客户端本地API
    • 开发者必读
      • 接入指南
    • 服务端API
      • 开发指南
        • 如何调用服务端API
        • 服务端API错误码对照表
      • 获取访问凭证
        • 获取客户端API访问凭证
    • 客户端API
      • 开发指南
        • 如何调用客户端API
        • 客户端API报文加解密流程
        • 客户端API错误码对照表
      • 向日葵企业主控端能力
        • 主控端调起协议
        • 指定设备ID/识别码发起远控
        • 在设备列表中定位指定设备ID并发起远控
        • 检测应用程序是否存活
      • 向日葵企业被控端能力
        • 获取当前设备信息
    • 参考
      • 调用过程及示例代码
  1. 企业子账号管理

查询子账号列表

GET
https://api.oraydev.cn/sl/v1/enterprise/users
查询子账号列表
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api.oraydev.cn/sl/v1/enterprise/users?offset=0&limit=10&department_ids&keyword&account&email&mobile&filter_isenble&filter_isverified&is_provide' \
--header 'Authorization: Bearer ${access_token}'
响应示例响应示例
200 - 示例 1
{
  "total": 0,
  "users": [
    {
      "account": "string",
      "admin_department_ids": [
        0
      ],
      "bind_user": {
        "account": "string",
        "ent_id": 0,
        "oray_userid": 0,
        "user_id": 0
      },
      "create_time": "string",
      "department_ids": [
        0
      ],
      "email": "string",
      "ent_id": 0,
      "ent_nickname": "string",
      "expire_time": "string",
      "group_ids": [
        0
      ],
      "group_name": "string",
      "groups": [
        {
          "amount": 0,
          "create_time": 0,
          "current_user_groups": [
            0
          ],
          "department_id": 0,
          "department_ids": [
            0
          ],
          "depth": 0,
          "ent_id": 0,
          "group_id": 0,
          "is_admin": true,
          "is_clear": true,
          "is_default": 0,
          "is_department": true,
          "key": "string",
          "name": "string",
          "parent_id": 0,
          "sort": 0,
          "sorts": [
            {
              "group_id": 0,
              "sort": 0
            }
          ],
          "user_ids": [
            0
          ],
          "visible_range": 0
        }
      ],
      "is_auto_disable_on_expiry": true,
      "is_delete": true,
      "is_enble": true,
      "is_ent_admin": true,
      "is_ewei_engineer": true,
      "is_provide": 0,
      "is_verified": true,
      "is_webctrl": true,
      "last_active_time": "string",
      "last_controlled_time": "string",
      "mobile": "string",
      "nick": "string",
      "open_userid": "string",
      "passes": [
        {
          "account": "string",
          "ent_id": 0,
          "is_lock": 0,
          "last_active_time": "string",
          "password": "string",
          "password_md5": "string",
          "retry_count": 0,
          "signingkey": "string",
          "update_time": "string",
          "user_id": 0
        }
      ],
      "reminder_time": "string",
      "remote_limit": 0,
      "seat_open": true,
      "skip_check": true,
      "update_time": "string",
      "user_id": 0
    }
  ]
}

请求参数

Query 参数
offset
integer 
可选
查询偏移量,配合limit实现分段读取.
示例值:
0
limit
integer 
查询输出的记录数
可选
示例值:
10
department_ids
string 
部门ID
可选
keyword
string 
搜索关键字
可选
account
string 
账号
可选
email
string 
邮箱
可选
mobile
string 
手机号
可选
filter_isenble
integer 
可选
启用状态查询,0:全部,1:未启用,2:已启用
filter_isverified
integer 
可选
加入状态查询,0:全部,1:未加入,2:已加入
is_provide
integer 
是否是第三方导入
可选
Header 参数
Authorization
string 
必需
需要用子账号身份授权获取到的access_token
示例值:
Bearer ${access_token}

返回响应

🟢200成功
application/json
OK
Body
total
integer 
可选
users
array [object {32}] 
可选
account
string 
账号
可选
admin_department_ids
array[integer]
部门管理者
可选
bind_user
object 
绑定贝锐账号
可选
create_time
string 
创建时间
可选
department_ids
array[integer]
部门id
可选
email
string 
邮箱
可选
ent_id
integer 
企业id
可选
ent_nickname
string 
企业别称
可选
expire_time
string 
过期时间
可选
group_ids
array[integer]
角色权限
可选
group_name
string 
分组名称
可选
groups
array[object (entity.RbacGroup) {19}] 
权限分组集合
可选
is_auto_disable_on_expiry
boolean 
是否过期自动禁用
可选
is_delete
boolean 
是否已被删除
可选
is_enble
boolean 
允许登录
可选
is_ent_admin
boolean 
是否企业所有者
可选
is_ewei_engineer
boolean 
是否是易维客服
可选
is_provide
integer 
是否第三方账号
可选
is_verified
boolean 
是否加入企业
可选
is_webctrl
boolean 
开启web网页远控
可选
last_active_time
string 
最后登陆时间
可选
last_controlled_time
string 
开启web网页远控
可选
mobile
string 
手机
可选
nick
string 
昵称
可选
open_userid
string 
第三方唯一ID
可选
passes
array[object (entity.EnterpriseUserPass) {10}] 
密码
可选
reminder_time
string 
可选
到期前提醒时间(分钟为单位)
remote_limit
integer 
可控主机数
可选
seat_open
boolean 
开启坐席
可选
skip_check
boolean 
检查用户数限制
可选
update_time
string 
更新时间
可选
user_id
integer 
子账号id
可选
🟠400请求有误
上一页
删除企业子账号
下一页
获取指定子账号信息
Built with