删除组织讨论¶

DELETE /api/v5/orgs/{org}/discuss/{number}

该接口用于删除指定组织下的讨论。通过组织路径与讨论编号定位目标讨论，删除成功后返回 200 状态码，响应体为空。

访问令牌支持说明¶

AtomGit 用户访问令牌（AtomGit user access tokens）

是否允许匿名访问¶

此接口不允许匿名访问

请求参数¶

参数名	位置	类型	必填	说明
`org`	path	string	是	组织路径(path)
`number`	path	integer	是	讨论编号,取值需为非负数(`@PositiveNumber`)
`access_token`	query	string	是	用户授权码

请求示例¶

参数说明¶

<org> 替换为组织的地址 path(企业、组织或个人的地址 path); <number> 替换为待删除的组织讨论编号(非负整数); <token> 替换为你的 AtomGit 用户访问令牌。

cURL¶

curl -X DELETE 'https://api.atomgit.com/api/v5/orgs/<org>/discuss/<number>?access_token=<token>'

JavaScript¶

// 原生 fetch (Node.js 18+ / 浏览器)
const response = await fetch("https://api.atomgit.com/api/v5/orgs/<org>/discuss/<number>?access_token=<token>", {
  method: "DELETE",
});

if (!response.ok) {
  throw new Error(`请求失败: ${response.status}`);
}

console.log(`删除成功: HTTP ${response.status}`);

Python¶

import requests

resp = requests.delete(
    "https://api.atomgit.com/api/v5/orgs/<org>/discuss/<number>",
    params={"access_token": "<token>"},
    timeout=10,
)
resp.raise_for_status()

print(resp.status_code)

响应参数¶

该接口删除成功后返回 200 OK,响应体为空,无返回字段。

响应示例¶

状态码： 200

{}

失败响应¶

当请求失败时,接口返回对应的 HTTP 状态码,响应体为错误信息(字段名以实际返回为准)。

400 参数错误

{
  "errorCode": 400,
  "errorCodeName": "BAD_REQUEST",
  "errorMessage": "参数 类型错误",
  "traceId": ""
}

401 未认证

{
  "errorCode": 401,
  "errorCodeName": "UNAUTHORIZED",
  "errorMessage": "Unauthorized",
  "traceId": ""
}

404 未找到

{
  "errorCode": 404,
  "errorCodeName": "NOT_FOUND",
  "errorMessage": "Not Found",
  "traceId": ""
}

HTTP 响应状态码¶

状态码	说明
`200`	成功(OK),删除成功
`400`	参数错误(Bad Request)
`401`	需要认证(Requires authentication)
`403`	禁止访问(Forbidden)
`404`	组织或讨论不存在(Not Found)
`429`	请求过于频繁(Too Many Requests)
`500`	系统内部错误(Internal Server Error)

错误码¶

错误码	说明
`400`	参数错误或请求无法解析
`401`	未认证或凭证无效(缺少/无效的访问凭证)
`403`	无权限执行删除操作
`404`	组织或讨论不存在
`429`	请求过于频繁,触发限流
`500`	系统内部错误

本页原文 Markdown：在 AtomGit 查看·内容源自开源项目 gitcode-dev/atomgit-api-doc