更新时间:2024-04-29 GMT+08:00

分页查询用户

描述

企业管理员通过该接口分页查询企业用户。

调试

您可以在API Explorer中调试该接口。

接口原型

表1 接口原型

请求方法

GET

请求地址

/v1/usg/dcs/corp/member

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

offset

Integer

Query

查询偏移量, 若超过最大数量,则返回最后一页。

limit

Integer

Query

查询数量。

默认值:10

searchKey

String

Query

搜索条件,支持名称、手机、邮箱、账号、第三方User ID模糊搜索。

sortField

String

Query

排序字段名称。

支持的取值:

  • userType
  • adminType
  • ldapAccount
  • deptCode
  • status
  • sortLevel

isAsc

Boolean

Query

是否按升序排序。

deptCode

String

Query

部门编码,不带则查询所有。

enableSubDept

Boolean

Query

是否查询子部门。

默认值: true

adminType

Integer

Query

根据管理员类型查询。

  • 1:普通管理员
  • 2:非管理员

enableRoom

Boolean

Query

查询SmartRooms用户。

说明:

该参数将废弃,请勿使用。

userType

Array of integers

Query

用户类型,若不携带,则默认查询普通用户。

  • 2:普通用户
  • 12:智慧屏用户
  • 13:IdeaHub用户
  • 14:SmartRooms用户

status

Integer

Query

用户状态。不带则查询所有。

  • 0:正常
  • 1:停用

containsUnActive

Boolean

Query

是否查询未激活的终端。

默认值:false

说明:

该参数将废弃,请勿使用。

X-Access-Token

String

Header

授权令牌。获取“执行App ID鉴权”响应的accessToken。

X-Request-Id

String

Header

请求requestId,用来标识一路请求,用于问题跟踪定位,建议使用UUID,若不携带,则后台自动生成。

Accept-Language

String

Header

语言参数,默认为中文zh-CN,英文为en-US。

状态码

表3 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常

响应参数

表4 响应参数

参数

类型

描述

count

Integer

总数量。

limit

Integer

每页显示的条目数量。

默认值:10。

offset

Integer

页面起始页,从0开始。

data

Array of SearchUserResultDTO objects

分页查询企业用户信息。

表5 SearchUserResultDTO 数据结构

参数

类型

描述

activeCode

String

激活码。

activeCodeExpireTime

Long

激活码到期时间,utc时间戳。

activeTime

Long

激活时间,utc时间戳。

adminType

Integer

管理员类型。

  • 0:默认(超级)管理员
  • 1:普通管理员
  • 2:非管理员(即为普通企业成员,UserType是2时有效)

country

String

手机所属国家。

deptCode

String

部门编码。

deptNamePath

String

部门完整名称。

desc

String

备注。

email

String

邮箱。

englishName

String

英文名称。

expireTime

Long

已激活的终端到期时间,utc时间戳。

hidePhone

Boolean

是否隐藏手机号码。

id

String

用户UUID。

license

Integer

许可证。

  • 0:商用
  • 1:免费试用

name

String

名称。

phone

String

联系电话。

signature

String

签名。

sortLevel

Integer

通讯录排序等级,序号越低优先级越高。

maximum:10000

minimum:1

status

Integer

用户状态。

  • 0:正常
  • 1:停用

thirdAccount

String

第三方User ID。

title

String

职位。

userAccount

String

华为云会议账号。

userType

Integer

用户类型。

  • 2:普通用户
  • 12:智慧屏用户
  • 13:IdeaHub用户
  • 14:SmartRooms用户

visionAccount

String

智慧屏账号。

vmrId

String

个人会议ID。

请求消息示例

GET /v1/usg/dcs/corp/member
Connection: keep-alive
X-Access-Token: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9
Content-Type: application/json
Content-Length: 125
Host: api.meeting.huaweicloud.com 
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)

响应消息示例

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 1329
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Server: api-gateway
X-Request-Id: 63facce44898efa03629afd189da7f0f

{
    "count": 1,
    "data": [
        {
            "activeCode": null,
            "activeCodeExpireTime": null,
            "activeTime": 1601221696783,
            "adminType": 2,
            "country": "chinaPR",
            "deptCode": "1",
            "deptNamePath": "根部门",
            "desc": "desc",
            "email": "******",
            "englishName": "englishName",
            "expireTime": null,
            "hidePhone": false,
            "id": "a7f78791553d4ec6b3a4b721f0946286",
            "license": 0,
            "name": "name",
            "phone": "+86123456789",
            "signature": "signature",
            "sortLevel": 10000,
            "status": 0,
            "thirdAccount": "thirdAccount",
            "title": "manager",
            "userAccount": "4036ca5e54d144d9b9e3ed25b9368d3a",
            "userType": 2,
            "visionAccount": null,
            "vmrId": "911150978"
        }
    ],
    "limit": 10,
    "offset": 0
}

错误码

当您使用华为云会议服务端API时,如果遇到“MMC”或者“USG”开头的错误码,请参考华为云API错误中心

CURL命令示例

curl -k -i -X GET -H 'X-Access-Token: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/member