文档首页/应用身份管理服务 OneAccess/API参考/API/管理类接口/应用账号管理/新增应用账号 - CreateAppAccount
更新时间：2025-11-03 GMT+08:00
查看PDF
分享

新增应用账号 - CreateAppAccount

功能介绍

为用户创建应用账号并授权。

接口约束

null

URI

POST /api/v2/tenant/applications/{application_id}/accounts/basic-account

表1 路径参数

参数

是否必选

参数类型

描述

application_id

是

String

应用id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

是

String

该字段内容填为“application/json;charset=utf8”。

Authorization

是

String

认证凭据，值：Bearer {access_token}，access_token通过“获取访问凭据”接口获取。

表3 请求Body参数

参数

是否必选

参数类型

描述

user_id

是

String

应用账号关联的授权用户id。

account_name

否

String

应用账号名，为空默认为用户名。

name

否

String

应用账号名称。

org_code

否

String

应用机构编码。

password

否

String

应用账号密码。

disabled

否

Boolean

应用账号是否禁用，为空默认为非禁用。

extension

否

Object

自定义扩展属性，需要在应用“对象模型”—“应用账号模型”自定义。

响应参数

状态码：201

表4 响应Body参数

参数

参数类型

描述

account_id

String

应用账号id。

状态码：400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误编号。

error_msg

String

错误详情。

请求示例

创建指定应用的应用账号并关联指定用户，账号名为zhangshan，账号名称为zs，关联用户的user_id为20220331164602949-904C-D475B60AE，应用账号为启用状态。

POST https://{domain_name}/api/v2/tenant/applications/{application_id}/accounts/basic-account

Authorization: Bearer 334963fc-1e4a-473b-9096-52a929140...

{
    "account_name":"zhangsan",
    "user_id":"20220331164602949-904C-D475B60AE",
    "name":"zs",
    "org_code":"",
    "password":"",
    "disabled":false,
    "extension":{}
}

响应示例

状态码：201

请求成功。

{
  "account_id" : "20210517100458591-6F1C-965A4C..."
}

状态码

状态码

描述

201

请求成功。

400

参数无效。

错误码

请参见错误码。

父主题：应用账号管理

相关文档