智慧服务,成就美好体验 项目咨询

主页 > 服务与支持 > 开发平台 > 服务端API参考 > 用户管理 用户查询自己的信息

入门使用

用户查询自己的信息

更新时间:2019-11-20

描述

企业用户通过该接口查询自己的信息。

接口原型

表1 接口原型

请求方法

GET

请求地址

/rest/usg/datacenter/v1/member

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

Authorization

String

Header

授权令牌。将执行鉴权响应的accessToken

进行Base64转码操作

样例:Basic Base64(accessToken)

响应参数

表3 参数说明

参数

类型

描述

returnCode

String

业务返回码。

returnMessage

String

返回描述。

achievementTime

String

响应产生时间。

requestId

String

请求唯一标识。

data

QueryUserResultDTO

查询用户的返回结果。

表4 QueryUserResultDTO 数据结构

参数

类型

描述

id

String

用户ID。

userAccount

String

帐号。

name

String

姓名。

englishName

String

英文名称。

phone

String

联系电话。

country

String

联系电话所属的国家。

email

String

邮箱。

sipNum

String

SIP号码。

vmrList

UserVmrDTO[0..*]

虚拟会议室ID。

deptCode

String

部门编码。

deptName

String

部门名称。

deptNamePath

String

部门完整名称。

userType

Integer

用户类型。

  • 0:系统管理员帐户
  • 1:SP管理员帐户
  • 2:企业成员帐户
  • 10:硬终端用户

adminType

Integer

管理员类型。

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

signature

String

签名。

title

String

职位。

desc

String

备注。

corp

CorpBasicInfoDTO

企业注册信息。只针对用户查询自己的信息这个接口有效。

function

UserFunctionDTO

用户功能位。

status

Integer

用户状态。

  • 0:正常
  • 1:停用

sortLevel

Integer

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

hidePhone

Boolean

是否隐藏手机号码。

表5 UserVmrDTO数据结构

参数

类型

描述

id

String

vmr的唯一标识。

vmrId

String

vmrId即预约会议的id,分为两种,一种是创建用户时生成的,为用户个人的,另一种是企业管理员分配的专用vmr。

vmrName

String

vmr虚拟会议室名称。

vmrPkgId

String

若为专用vmr,则对应vmr套餐包的id。

vmrPkgName

String

若为专用vmr,则对应vmr套餐包的名称。

vmrPkgParties

Integer

若为专用vmr,则其该vmr虚拟会议室对应购买的套餐方数。

vmrPkgLength

Integer

若为专用vmr,则其该vmr虚拟会议室对应购买的与会时间,若为0则代表无限时长。

status

Integer

vmr虚拟会议室状态。

  • 0:正常
  • 1:停用
  • 2:未分配
表6 CorpBasicInfoDTO 数据结构

参数

类型

描述

id

String

企业ID。

name

String

企业名称。

address

String

企业所在地。

adminName

String

管理员名称。

account

String

管理员帐号。

phone

String

管理员手机。

country

String

管理员手机所属的国家。

email

String

管理员邮箱。

enableSMS

Boolean

是否发送短信。

enableCloudDisk

Boolean

是否开启云盘

enablePstn

Boolean

是否具有pstn功能。

autoUserCreate

Boolean

是否支持自动开户。

请求消息示例

GET /rest/usg/datacenter/v1/member
Connection: keep-alive
Authorization: Basic UkNuSkYzQW9SR3BDcm5RWURoQ2dUTkplR3Z3aHBRNFFj
Host: api.meeting.huaweicloud.com
User-Agent: Apache-HttpClient/4.5.3 (Java/1.8.0_191)
 

响应消息示例

HTTP/1.1 200 
Date: Mon, 25 Mar 2019 12:42:39 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 812
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: c94f64967745b0670c299c0688479078
Server: api-gateway
X-Request-Id: de796b739528b6a1f72c283a107bdb02

{
    "returnCode":"000000000",
    "returnMessage":"Success",
    "achievementTime":"2019-03-25 12:41:53.659",
    "requestId":"de796b739528b6a1f72c283a107bdb02",
    "data":
    {
        "id":"ff80808169570fea0169b3151d290107",
        "userAccount":"user001",
        "name":"user001",
        "phone":null,
        "email":"user001@huawei.com",
        "sipNum":"+8657*******",
        "vmrList":[
        {
            "id":"ff80808169570fea0169b3151d3a0109",
            "vmrId":"911194747",
            "vmrName":"user001的云会议室",
            "vmrPkgId":null,
            "vmrPkgName":null,
            "vmrPkgParties":null,
            "status":0
        }],
        "deptCode":"1",
        "deptName":"user002",
        "deptNamePath":"user002",
        "userType":2,
        "adminType":2,
        "signature":null,
        "corp":
        {
            "id":"17432",
            "name":"user003",
            "address":null,
            "adminName":"user003",
            "account":"user003",
            "phone":null,
            "email":"user003@huawei.com"
        },
        "status":0
    }
}
 

CURL命令示例

curl -k -i -X GET -H 'Authorization:Basic T3IxeXdMUGwzeU9Gb3JnWENNWWZldnBHM0JTQVA5N2FS' https://api.meeting.huaweicloud.com/rest/usg/datacenter/v1/member