更新时间:2024-04-28 GMT+08:00
分享

添加用户

描述

企业管理员通过该接口添加企业用户。

默认添加用户后,用户第一次登录华为云会议App或者Portal时需要修改密码。若需关闭第一次登录修改密码,请联系华为销售人员,并提供华为云会议企业ID。

调试

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

接口原型

表1 接口原型

请求方法

POST

请求地址

/v1/usg/dcs/corp/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。

account

String

Body

华为云会议用户账号,若携带则以携带为准,否则后台自动生成。账号整系统唯一。

账号只能包含大小写字母、数字、_、-、.、@符号,不能为纯数字和@后面带.号。

maxLength:64

minLength:0

说明:

账号/密码鉴权方式时需要填写。

thirdAccount

String

Body

第三方User ID。第三方User ID需要企业内唯一。

说明:

App ID鉴权方式时需要填写。

country

String

Body

手机号所属的国家

默认值:chinaPR。

maxLength:255

minLength:0

deptCode

String

Body

部门编码,若不携带则默认根部门。

默认值:1

desc

String

Body

备注。

maxLength:128

minLength:0

email

String

Body

邮箱。

maxLength:255

minLength:0

说明:

统一的邮箱格式,如果企业关闭短信功能,邮箱必填,否则手机、邮箱必填其一。

englishName

String

Body

企业用户的英文名称。

maxLength:64

minLength:0

function

UserFunctionDTO object

Body

用户功能位。

hidePhone

Boolean

Body

是否隐藏手机号码。默认值:false。

  • true:在通讯录和会议中不显示手机号码
  • false:在通讯录和会议中显示手机号码

name

String

Body

企业用户名称。

maxLength:64

minLength:1

phone

String

Body

手机号,必须加上国家码。

例如中国大陆手机为“+86xxxxxxxxxxx”。当填写手机号时 “country”参数必填。

手机号只允许输入纯数字。

说明:手机号或者邮箱至少填写一个。

pwd

String

Body

企业用户账号的密码。若携带则以实际携带为准,否则后台默认生成,密码必须满足:

1、8-32位

2、不能和账号的正序和倒序一致

3、至少包含两种字符类型:小写字母、大写字母、数字、特殊字符(` ~ ! @ # $ % ^ & * ( ) - _ = + | [ { } ] ; : " ,’ < . > / ?)

sendNotify

String

Body

是否发送开户的邮件和短信通知。

  • 0:不发送
  • 不填或者其他值就发送,默认发送

signature

String

Body

签名。

maxLength:512

minLength:0

sortLevel

Integer

Body

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

默认值:10000

maximum:10000

minimum:1

status

Integer

Body

用户状态。

  • 0:正常
  • 1:停用

默认值:0

title

String

Body

职位。

maxLength:32

minLength:0

表3 UserFunctionDTO 数据结构

参数

是否必须

类型

位置

描述

enableRoom

Boolean

Body

是否开启智能协同白板功能。如果开启,表示该账号是给智能协同白板使用,占用企业智能协同白板的资源,如果资源不足,则无法开启。

默认值:false。

状态码

表4 状态码说明

HTTP状态码

描述

200

操作成功。

400

参数异常。

401

未鉴权或鉴权失败。

403

权限受限。

500

服务端异常

响应参数

表5 响应参数

参数

类型

描述

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

用户UUID。

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:普通用户
  • 12:智慧屏用户
  • 13:IdeaHub用户
  • 14:SmartRooms用户

visionAccount

String

智慧屏唯一账号

vmrList

Array of UserVmrDTO objects

云会议室列表。

表6 QueryDeviceInfoResultDTO 数据结构

参数

类型

描述

deviceSize

String

设备终端产品尺寸。

model

String

终端型号。

purchaseChannel

String

终端设备购买渠道。

请求消息示例

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

{
    "englishName": "englishName",
    "country": "chinaPR",
    "signature": "signature-info",
    "hidePhone": false,
    "sendNotify": "0",
    "title": "manager",
    "sortLevel": 100000,
    "phone": "+86173****9807",
    "function": {
        "enableRoom": true
    },
    "name": "name",
    "pwd": "******",
    "account": "3e48b79b660e403cb5e0208f7be83961",
    "email": "******",
    "deptCode": "1",
    "desc": "desc",
    "status": "status"
}

响应消息示例

HTTP/1.1 200 
Date: Wed, 18 Dec 2019 06:20:40 GMT
Content-Type: application/json;charset=UTF-8
Content-Length: 160
Connection: keep-alive
Pragma: No-cache
Cache-Control: no-cache
Expires: Thu, 01 Jan 1970 00:00:00 GMT
Server: api-gateway
X-Request-Id: ebbb9b1e50d1ec63b78d8484d170173f

{
    "id": "f521bebcbb27422cb3241c4cb19942c5",
    "userAccount": "3e48b79b660e403cb5e0208f7be83961",
    "name": "name",
    "englishName": "englishName",
    "phone": "+86173****9807",
    "country": "chinaPR",
    "email": "******",
    "sipNum": "+8657198480",
    "deptCode": "1",
    "deptName": "根部门",
    "deptNamePath": "根部门",
    "userType": 2,
    "adminType": 2,
    "signature": "signature-info",
    "title": "manager",
    "desc": "desc",
    "corp": null,
    "function": {
        "enableRoom": true
    },
    "devType": {
        "model": null,
        "deviceSize": null,
        "purchaseChannel": null
    },
    "status": 0,
    "sortLevel": 10000,
    "hidePhone": false,
    "visionAccount": null,
    "thirdAccount": "thirdAccount",
    "license": 0,
    "activeTime": 1601221696783,
    "vmrList": [
        {
            "id": "2c908bc76f61a5f2016f61bbfdf5039b",
            "vmrId": "912992631",
            "vmrName": "name的云会议室",
            "vmrPkgId": null,
            "vmrPkgName": null,
            "vmrPkgParties": null,
            "vmrPkgLength": null,
            "status": "0"
        }
    ]
}

错误码

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

CURL命令示例

curl -k -i -H 'content-type: application/json' -X POST -H 'X-Access-Token: stb7PzruAmA6d3JJD578jlAHczGfN4SIaup9' -d '{"account": "test963","country": "chinaPR","deptCode": "1","email": "******","name": "test963","phone": "+86136********","pwd": "******"}' https://api.meeting.huaweicloud.com/v1/usg/dcs/corp/member

相关文档