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

用户查询自己的信息

描述

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

调试

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

接口原型

表1 接口原型

请求方法

GET

请求地址

/v1/usg/dcs/member

传输协议

HTTPS

请求参数

表2 参数说明

参数

是否必须

类型

位置

描述

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 响应参数

参数

类型

描述

activeTime

Long

激活时间,utc时间戳。

adminType

Integer

管理员类型。

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

corp

CorpBasicInfoDTO object

企业注册信息。仅用户查询自己的信息才返回该数据。

country

String

联系电话所属的国家。

deptCode

String

部门编码。

deptName

String

部门名称。

deptNamePath

String

部门完整名称。

desc

String

备注。

devType

QueryDeviceInfoResultDTO object

绑定设备类型信息。

email

String

邮箱。

englishName

String

英文名称。

function

UserFunctionDTO object

用户功能位。

hidePhone

Boolean

是否隐藏手机号码。

id

String

用户id。

license

Integer

许可证。

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

name

String

名称。

phone

String

联系电话。

signature

String

签名。

sipNum

String

SIP号码。

sortLevel

Integer

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

status

Integer

用户状态。

  • 0:正常;
  • 1:停用。

thirdAccount

String

第三方User ID。

title

String

职位。

userAccount

String

华为云会议用户账号。

userType

Integer

用户类型。

  • 2:企业成员账户

visionAccount

String

智慧屏唯一账号

vmrList

Array of UserVmrDTO objects

云会议室列表。

表5 UserVmrDTO数据结构

参数

类型

描述

id

String

云会议室的ID。

说明:

对应创建会议接口中的vmrID。

vmrId

String

云会议室的固定会议ID。

说明:

对应创建会议接口返回数据的vmrConferenceID。

vmrName

String

云会议室名称。

vmrMode

Integer

VMR模式。

  • 0:个人会议ID
  • 1:云会议室
  • 2:网络研讨会

vmrPkgId

String

云会议室套餐包的id,仅云会议室返回。

vmrPkgLength

Integer

云会议室套餐包的与会时间,若为0则代表无限时长,仅云会议室返回。

vmrPkgName

String

云会议室套餐包的名称,仅云会议室返回。

vmrPkgParties

Integer

云会议室套餐包的会议并发方数,仅云会议室返回。

status

Integer

云会议室状态。

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

参数

类型

描述

account

String

管理员账号。

address

String

企业所在地。

adminName

String

管理员名称。

autoUserCreate

Boolean

是否支持自动开户。

country

String

管理员手机所属的国家。

email

String

管理员邮箱。

enablePstn

Boolean

是否具有pstn功能。

enableSMS

Boolean

是否通过短信形式发送会议通知。

id

String

企业id。

name

String

企业名称。

phone

String

管理员手机。

enableCloudDisk

Boolean

是否开启云盘

corpType

Integer

企业类型

请求消息示例

GET /v1/usg/dcs/member
Connection: keep-alive
X-Access-Token: stbLRonxHFt7jfbMHSY2UufNZewbPwb8TP8y
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: 812
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
http_proxy_id: c94f64967745b0670c299c0688479078
Server: api-gateway
X-Request-Id: de796b739528b6a1f72c283a107bdb02

{
    "id": "ff808081699b56cb0169b81a06ee00d9",
    "userAccount": "user8001@corpnew",
    "name": "test008",
    "englishName": null,
    "phone": null,
    "country": null,
    "email": "******",
    "sipNum": "+991116003840",
    "vmrList": [
        {
            "id": "ff808081699b56cb0169b81a06f400db",
            "vmrId": "913371462",
            "vmrName": "user8001的云会议室",
            "vmrMode": 0,
            "vmrPkgId": null,
            "vmrPkgName": null,
            "vmrPkgParties": null,
            "vmrPkgLength": null,
            "status": 0
        },
        {
            "id": "ff808081699b56cb0169b92b45ab0111",
            "vmrId": "919728047",
            "vmrName": "云会议室:919728047",
            "vmrMode": 1,
            "vmrPkgId": "ff808081680d5b8601682b3436070030",
            "vmrPkgName": "运营VMR专用_25",
            "vmrPkgParties": 25,
            "vmrPkgLength": 0,
            "status": 0
        }
    ],
    "deptCode": "1",
    "deptName": "wangyue",
    "deptNamePath": "wangyue",
    "userType": 2,
    "adminType": 2,
    "signature": null,
    "title": null,
    "desc": null,
    "corp": {
        "id": "15659",
        "name": "华为技术有限公司",
        "address": "hangzhou",
        "adminName": "wlj",
        "account": "d74cf0a5c7804860a131ec6067a10fc6",
        "phone": "+86********",
        "country": "chinaPR",
        "email": "********@huawei.com",
        "enableSMS": true,
        "enablePstn": false,
        "autoUserCreate": true
    },
    "function": {
        "enableRoom": false
    },
    "status": 0,
    "sortLevel": 10000,
    "hidePhone": false
}

错误码

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

CURL命令示例

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