---
order: 2
navTitle: 添加用户
---
# 添加用户

用于第三方应用添加一个新的用户。

说明：配置第三方应用为[授信应用](../../../../sys-settings/security/trustedapps.md)的时候需要勾选上`更新组织架构`。

## 调用说明

请求方式： `POST`\
请求url：`/api/trustedapp/addUser`\
请求参数示例：

```json
{
    "appid": "5rc6t7vyb8u9nimpo",
    "app_secret": "q3zw4xe5cr68vt79by80un9ie5r6ctv7yb8uio",
    "userDirectory": "sys",
    "user": {
        "userId": "ertyuoipo",
        "userName": "张三",
        "phone": "13112345678",
        "email": "xxx@email",
        "password": "465f76g8uhio",
        ...
    }
}
```

参数说明：

| 参数          | 必须 | 说明                                                             |
| :------------ | :--- | :--------------------------------------------------------------- |
| appid         | 是   | 授信应用ID                                                       |
| app\_secret    | 是   | 授信应用秘钥                                                     |
| userDirectory | 否   | 用户类型，`sys`代表系统用户，`external`代表外部用户，默认为`sys` |
| user          | 是   | 用户信息                                                         |
| userId        | 是   | 用户ID                                                           |
| userName      | 是   | 用户名称                                                         |
| password      | 否   | 明文密码，不传系统将会生成一个随机字符串填入                     |

说明：如果需要添加其他用户信息也通过在user对应属性中添加。

## 返回值说明

示例：

```json
{
    "result": false,
    "errorCode": "appNotFound",
    "message": "app 不存在",
}
```

参数说明：

| 参数      | 说明         |
| :-------- | :----------- |
| result    | 是否操作成功 |
| errorCode | 错误码       |
| message   | 错误文本提示 |

`errorCode` 说明：

| errorCode      | 说明                             |
| :------------- | :------------------------------- |
| appNotFound    | 应用不存在                       |
| appDisabled    | 应用被禁用了                     |
| secretMismatch | 应用秘钥被禁用了                 |
| userFound      | 用户已经添加过了                 |
| duplicateKey   | 用户属性中有内容不满足唯一性限制 |