删除团队空间
接口信息
接口地址:/api/v1/space/{id}/delete
请求方式:POST
请求数据类型:无
响应数据类型:*/*
接口描述:
删除指定团队空间
请求示例:
POST /api/v1/space/1072/delete请求参数
请求头
| 参数名 | 类型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| Authorization | string | 是 | API Key | Bearer ak-xxxxeyJhbGciOiJIUzI1NiJ9 |
路径参数:
| 参数名称 | 参数说明 | 是否必须 | 数据类型 |
|---|---|---|---|
| id | 空间ID | 是 | integer(int64) |
响应参数:
| 参数名称 | 参数说明 | 类型 | schema |
|---|---|---|---|
| code | 业务状态码,0000 表示成功,其余失败 | string | |
| displayCode | 源系统状态码,用于问题跟踪 | string | |
| message | 错误描述信息 | string | |
| data | 返回的具体业务数据 | object | |
| tid | 跟踪唯一标识 | string | |
| success | boolean |
响应示例:
javascript
{
"code": "0000",
"displayCode": "0000",
"message": "成功",
"data": null,
"tid": "3924521776083276197",
"success": true
}CURL示例
shell
curl 'http://127.0.0.1:8081/api/v1/space/1072/delete' \
-X POST \
-H 'Authorization: Bearer ak-d1f2129c4ba24629b8448af3354f9dd0'
{"code":"0000","displayCode":"0000","message":"成功","data":null,"tid":"3924521776083276197","success":true}测试用例
| # | 场景 | 状态码 | 结果 |
|---|---|---|---|
| 1 | 删除已有空间 | 0000 | 成功 |
| 2 | 删除不存在的空间 | 4030 | 失败,提示"无权限" |
TS模板示例
ts
// 响应接口
export interface DeleteSpaceRes {
code: string;
displayCode: string;
message: string;
data: object | null;
tid: string;
success: boolean;
}
/**
* 删除团队空间
* @param {number} id - 空间ID
* @returns
*/
export function deleteSpace(id: number): Promise<DeleteSpaceRes> {
return request.post(`/api/v1/space/${id}/delete`);
}