更新时间:2023-10-19 GMT+08:00
分享

删除用户

场景描述

调用此接口来删除租户下某一业务用户或者多个业务用户。

接口方法

DELETE

接口URI

https://域名/apiaccess/rest/sum/v1/tenantSpaces/users/{userIds},例如域名是service.besclouds.com。

URL参数

表1 URL参数

序号

参数

是否为必选

类型

描述

1

userIds

String[]

用户唯一标识,多个标识时,以英文逗号来分隔。

请求说明

表2 请求头参数

序号

名称

参数类型

是否必选

说明

1

X-APP-Key

string

False

app标识。

2

Authorization

string

True

鉴权字段,内容格式为: Bearer +tokenByAKSK接口的返回值中AccessToken(Bearer后有空格)。

响应说明

  • 响应状态码: 200
    表3 响应体参数

    序号

    名称

    参数类型

    说明

    1

    message

    string

    描述。

    2

    retcode

    string

    错误码。取值如下:

    0:成功。

    非0:失败。

错误码

  • 响应状态码: 400

    错误的请求:请检查请求路径及参数。

  • 响应状态码: 401

    未授权:1. 请确认是否购买了相关服务。 2. 请联系客服人员检查您账号的当前状态。

  • 响应状态码: 403

    鉴权失败。

  • 响应状态码: 404

    请求的内容未找到:请检查请求的路径。

  • 响应状态码: 500

    业务失败:请依次确认您请求中各参数的取值。

报文样例

场景描述:删除用户

URL:https://域名/apiaccess/rest/sum/v1/tenantSpaces2/users/{userId}

  • 请求头:
DELETE  /rest/sum/v1/tenants/1532350938331/users/123231  HTTP/1.1
Authorization: Bearer <token>
Content-Type: application/json
  • 响应头:
Content-Length: xxx
Content-Type: application/json; charset=UTF-8
  • 响应消息:
{
"message": "",
"retcode": "0",
}

相关文档