更新时间:2024-08-30 GMT+08:00
分享

用户授权应用账号

功能介绍

为用户授予应用访问权限,并在应用中创建用户对应的应用账号。

接口约束

URI

POST /api/v2/tenant/users/{user_id}/applications/{application_id}/accounts

表1 路径参数

参数

是否必选

参数类型

描述

user_id

String

用户id。

application_id

String

应用id。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

Content-Type

String

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

Authorization

String

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

表3 请求Body参数

参数

是否必选

参数类型

描述

account_name

String

对用户授权应用,在应用中创建的应用账号名,可选参数,为空默认为用户名。

响应参数

状态码: 200

表4 响应Body参数

参数

参数类型

描述

account_id

String

应用账号id。

状态码: 400

表5 响应Body参数

参数

参数类型

描述

error_code

String

错误编号。

error_msg

String

错误详情。

请求示例

用户授权应用账号,在应用application_id中创建名为Test01的应用账号。

POST https://{domain_name}/api/v2/tenant/users/{user_id}/applications/{application_id}/accounts

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

{
    "account_name":"Test01"
}

响应示例

状态码: 200

请求成功。

{
  "account_id" : "20210621095931341-4CB3-122995..."
}

状态码

状态码

描述

200

请求成功。

400

参数无效。

错误码

请参见错误码

相关文档