成员管理

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,
    //邮箱地址
    "email":"[email protected]"
}

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/[email protected]

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/[email protected]&[email protected]'