# 成员管理

## 1. 注册企业用户

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

### 1.1 接口地址

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

### 1.2 请求参数示例

```java
{
    //【必填】邮箱地址
    "email": "api@analysys.com.cn",
    //用户名
    "userName": "api",
    //真实姓名
    "name": "接口用户",
    // 密码 【4.5.1之前的版本密码为必填，4.5.1之后为不必填】
    "password": "123456",
    // 手机号码
    "phone": "1380000000",
    //用户所属部门
    "department": "技术部"
}
```

> **角色**：通过接口添加的用户角色默认为平台成员。
>
> **认证参数**：接口必传 xtoken 参数，详情见 [平台接口认证](/integration/api.md#22-ping-tai-jie-kou-ren-zheng)。
>
> **操作用户**：接口如果要记录操作人，URL上带loginUser参数，详情见 [操作用户](/integration/api.md#51-cao-zuo-yong-hu)。

#### 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 返回结果示例

```java
{
    //用户新增成功会返回方舟产品中对应的用户ID
    "userId":1,
    //邮箱地址
    "email":"api@analysys.com.cn"
}
```

### 1.4 接口调用示例

```java
curl -H "Content-Type:application/json" -H "xtoken:9CF0444E9DFD9E3D9CAE49B79F939B61" -X POST --data '{
    "email": "api@analysys.com.cn",
    "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 请求参数示例

```java
{
    //【必填】状态：false为禁用 true为启用
    "activation": false
}
```

> **认证参数**：接口必传 xtoken 参数，详情见 [平台接口认证](/integration/api.md#22-ping-tai-jie-kou-ren-zheng)。
>
> **操作用户**：接口如果要记录操作人，URL上带loginUser参数，详情见 [操作用户](/integration/api.md#51-cao-zuo-yong-hu)。

#### 2.2.1 入参说明：

| 参数名称       | 类型      | 必填 | 说明                         | 枚举                      |
| ---------- | ------- | -- | -------------------------- | ----------------------- |
| email      | String  | Y  | 要禁用/启用的用户邮箱，备注：URL传参       |                         |
| activation | Boolean | Y  | false为禁用，true为启用。备注：Body参数 | <p>true</p><p>false</p> |

### 2.3 返回结果示例

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

### 2.4 接口调用示例

```java
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'
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://arkdocs.analysys.cn/integration/api/api-manage-enterprise/api-enterprise-user.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.