成员管理

1. 注册企业用户

方舟企业管理后台支持多个项目成员共享,在添加项目成员前需要先注册用户。

1.1 接口地址

【POST】 /uba/manage/enterprise/accounts

1.2 请求参数示例

{
//【必填】邮箱地址
"email": "[email protected]",
//用户名
"userName": "api",
//真实姓名
"name": "接口用户",
// 密码 【4.5.1之前的版本密码为必填,4.5.1之后为不必填】
"password": "123456",
// 手机号码
"phone": "1380000000",
//用户所属部门
"department": "技术部"
}
角色:通过接口添加的用户角色默认为平台成员。
认证参数:接口必传 xtoken 参数,详情见 平台接口认证
操作用户:接口如果要记录操作人,URL上带loginUser参数,详情见 操作用户

1.2.1 入参说明:

参数名称
类型
必填
说明
email
String
Y
邮箱 不能重复 可用于登录
userName
String
N
用户名:不能重复 可用于登录
name
String
N
真实姓名:常用于展示
password
String
N
登录密码【 4.5.1版本修改为不必填】
phone
String
N
手机号码:不能重复 可用于登录
department
String
N
用户所属部门

1.3 返回结果示例

{
//用户新增成功会返回方舟产品中对应的用户ID
"userId":1,
//邮箱地址
}

1.4 接口调用示例

curl -H "Content-Type:application/json" -H "xtoken:9CF0444E9DFD9E3D9CAE49B79F939B61" -X POST --data '{
"email": "[email protected]",
"userName": "api",
"name": "接口用户",
"password": "123456",
"phone": "1380000000",
"department": "技术部"
}' http://127.0.0.1:4005/uba/manage/enterprise/accounts?loginUser=admin@analysys.com.cn

2. 禁用/启用企业用户

禁用企业用户不会将用户记录删除,只会修改为不可用,禁用只会的帳号将不能登录方舟系统,如果需要继续使用,需要调用接口恢复用户状态。

2.1 接口地址

【POST】 /uba/manage/ enterprise/accounts/activation

2.2 请求参数示例

{
//【必填】状态:false为禁用 true为启用
"activation": false
}
认证参数:接口必传 xtoken 参数,详情见 平台接口认证
操作用户:接口如果要记录操作人,URL上带loginUser参数,详情见 操作用户

2.2.1 入参说明:

参数名称
类型
必填
说明
枚举
email
String
Y
要禁用/启用的用户邮箱,备注:URL传参
activation
Boolean
Y
false为禁用,true为启用。备注:Body参数
true
false

2.3 返回结果示例

{
//0 表示返回成功
"success":0
}

2.4 接口调用示例

curl -H "Content-Type:application/json" -H "xtoken:9CF0444E9DFD9E3D9CAE49B79F939B61" -X POST --data '{
"activation": false
}' 'http://127.0.0.1:4005/uba/manage/enterprise/accounts/activation?loginUser=admin@analysys.com.cn&email=api@analysys.com.cn'