新增站点第三方成员
更新时间：2021-09-06
接口描述
本接口用于新增 AIPAGE 站点第三方平台管理成员并设置角色，最终返回操作结果。添加的用户通过第三方平台oauth免登进入管理后台，不需要有百度智能云账号。
注意事项
- authorization header 签名时必须签名 host 头部，同时推荐签名所有 x-bce 开头 header。
- 使用本接口的前提是站点管理员已申请并完成 AIPAGE 第三方登录接入
请求结构
POST /v{version}/user?clientToken={clientToken}&siteId={siteId} HTTP/1.1
Host: aipage.baidubce.com
Authorization: authorization string
Body: {"username": "xxxx", "nickname": "xxx", "uid": "001", "app": "appName", "role": "editor", "roleId": ""}请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| version | String | 是 | URL参数 | API版本号 |
| clientToken | String | 是 | URL参数 | 幂等性Token，是一个长度不超过64位的ASCII字符串，详见幂等性。 |
| siteId | String | 是 | URL参数 | 站点 ID |
| username | String | 否 | Body参数 | 成员账号名 |
| nickname | String | 是 | Body参数 | 成员账号昵称 |
| portrait | String | 否 | Body参数 | 成员头像图片地址 |
| uid | String | 是 | Body参数 | 成员账号标识ID，需保持唯一 |
| app | String | 是 | Body参数 | 第三方平台oauth登录应用标识 |
| role | String | 否 | Body参数 | 设置成员的内置角色标识，参考下方内置角色说明 |
| roleId | String | 否 | Body参数 | 设置成员的自定义角色ID，从角色列表中获取 |
内置角色说明
| 角色标识 | 角色名称 | 角色权限 |
|---|---|---|
| site-admin | 站长 | 除续费外所有权限 |
| editor | 副站长 | 除续费和用户管理外所有权限 |
| dnr-user | 域名服务商用户 | 除续费、用户管理、域名管理外所有权限 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| success | Boolean | 是否操作成功 |
请求示例
POST https://aipage.baidubce.com/v1/user?siteId=71b6bedb-7827-4ac9-9d20-5c08ca2f0c0f&clientToken=3A8d84403d-a94b-40ce-9d6a-f6225dd26676
Host: aipage.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
Content-Type: application/json;charset=UTF-8
Body:
{"nickname": "nickname", "uid": "123", "role": "editor", "app": "app name"}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"success":true
}