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

新增应用账号

功能介绍

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

接口约束

无

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

参数无效。

错误码

请参见错误码。

父主题： 应用账号管理

相关文档