NoBase

Appearance

论坛帖子删除接口 ​

用于删除指定板块下的帖子，支持GET和POST两种请求方式。根据应用“令牌启用状态”自动选择验证方式（令牌或账号密码），需通过appid、uid（板块ID）、id（帖子ID）和signature校验请求合法性，同时验证删除权限（版主可删任意帖子，非版主仅可删自己的帖子）。

请求地址 GET / POST ​

http
https://nobase.cn/api/bbs/post_del

请求参数 ​

参数名位置类型必选说明
appidquerystring✅ 是应用ID，开发者中心获取的应用唯一标识
uidquerystring✅ 是板块ID，帖子所属板块的唯一标识（从板块列表接口获取）
idquerystring✅ 是帖子ID，需删除的帖子唯一标识（从帖子列表接口获取）
signaturequerystring✅ 是应用签名，与后台配置一致，用于验证请求合法性
tokenquerystring条件必选用户令牌，仅当令牌启用时需传递；需为当前应用下的有效令牌
userquerystring条件必选用户账号，仅当令牌未启用时需传递；仅支持纯数字格式（如手机号）
passquerystring条件必选用户密码，仅当令牌未启用时需传递；仅支持字母+数字组合（无中文/符号）

返回示例 ​

成功响应（删除操作完成） ​

json
{
  "code": 200,
  "msg": "success",
  "data": "操作成功"
}

失败响应（参数问题） ​

json
{
  "code": 204,
  "msg": "fail",
  "data": "接口参数错误：缺少id"
}
json
{
  "code": 204,
  "msg": "fail",
  "data": "接口参数错误：令牌启用需传token！"
}
json
{
  "code": 204,
  "msg": "fail",
  "data": "接口参数错误：令牌未启用需传user和pass！"
}

失败响应（身份验证异常） ​

json
{
  "code": 401,
  "msg": "fail",
  "data": "token无效或已过期（非当前应用/开发者）！"
}
json
{
  "code": 403,
  "msg": "fail",
  "data": "账号格式错误！仅支持数字账号！"
}
json
{
  "code": 404,
  "msg": "fail",
  "data": "用户账号密码错误！"
}

失败响应（权限/资源异常） ​

json
{
  "code": 405,
  "msg": "fail",
  "data": "权限不足：您无法删除他人帖子！"
}
json
{
  "code": 407,
  "msg": "fail",
  "data": "该帖子不存在！"
}
json
{
  "code": 404,
  "msg": "fail",
  "data": "帖子审核中！"
}

失败响应（配置/状态异常） ​

json
{
  "code": 400,
  "msg": "fail",
  "data": "应用配置错误：令牌状态必须为启用或未启用！"
}
json
{
  "code": 404,
  "msg": "fail",
  "data": "开发者账号已逾期(3天)，请缴费后重试！"
}

返回数据结构 ​

参数名类型说明
codenumber状态码：200=删除成功；204=参数缺失/错误；400=应用配置错误；401=token无效；402=签名失败；403=账号格式错误；404=资源不存在/状态异常（如帖子审核中、账号密码错误）；405=权限不足/操作失败；407=应用配置/板块/帖子不存在
msgstring状态描述：success=成功，fail=失败
datastring响应数据：返回操作结果提示或错误原因，如“操作成功”“权限不足：您无法删除他人帖子！”

代码示例 ​

javascript
// 令牌启用时删除帖子（需有效token）
const params = new URLSearchParams({
  appid: "your_app_id",
  uid: "2001", // 帖子所属板块ID
  id: "8001", // 待删除帖子ID
  token: "valid_user_token", // 有效令牌
  signature: "your_signature"
});

// 发起POST请求
fetch("https://nobase.cn/api/bbs/post_del", {
  method: "POST",
  body: params,
  headers: { "Content-Type": "application/x-www-form-urlencoded" }
})
.then(res => res.json())
.then(res => {
  if (res.code === 200) {
    console.log("帖子删除成功：", res.data);
  } else {
    console.error("删除失败：", res.data);
  }
})
.catch(err => console.error("请求异常：", err));
javascript
// 令牌未启用时删除帖子（需user和pass）
const url = new URL("https://nobase.cn/api/bbs/post_del");
url.searchParams.set("appid", "your_app_id");
url.searchParams.set("uid", "2002");
url.searchParams.set("id", "8002");
url.searchParams.set("user", "13800138000"); // 纯数字账号
url.searchParams.set("pass", "UserPass123"); // 字母+数字密码
url.searchParams.set("signature", "your_signature");

// 发起GET请求
fetch(url.toString())
.then(res => res.json())
.then(res => {
  res.code === 200 
    ? console.log("删除结果：", res.data)
    : console.error("错误：", res.data);
});
python
import requests

# 令牌启用时删除帖子
params = {
    "appid": "your_app_id",
    "uid": "2003",
    "id": "8003",
    "token": "valid_user_token",
    "signature": "your_signature"
}

response = requests.post(
    "https://nobase.cn/api/bbs/post_del",
    data=params,
    timeout=8
)
res_data = response.json()
print("删除结果：", res_data["data"])
python
import requests

# 令牌未启用时删除帖子
params = {
    "appid": "your_app_id",
    "uid": "2004",
    "id": "8004",
    "user": "13900139000",
    "pass": "UserPass456",
    "signature": "your_signature"
}

response = requests.get(
    "https://nobase.cn/api/bbs/post_del",
    params=params,
    timeout=8
)
res_data = response.json()
print(res_data)

注意事项

  1. 验证方式说明

    • 接口根据应用“令牌启用状态”自动选择验证方式：
      • 令牌启用：必须传递token，无需传递user和pass，否则返回参数错误；
      • 令牌未启用：必须传递user和pass，无需传递token，否则返回参数错误。
    • 两种验证方式不可混用，避免参数冲突。

  2. 权限校验规则

    • 版主（板块配置中指定的账号）可删除该板块下任意帖子；
    • 非版主仅可删除自己发布的帖子，删除他人帖子会返回“权限不足：您无法删除他人帖子！”；
    • 版主列表从板块配置中获取，需提前在后台完成版主设置。

  3. 操作前提条件

    • 帖子必须存在且状态非“审核中”（否则返回“帖子审核中！”或“该帖子不存在！”）；
    • 板块必须存在（否则返回“该板块不存在！”）；
    • 开发者账号需正常启用且VIP未逾期，应用需处于正常状态（非审核中、非停用）。

  4. 参数规范

    • user（令牌未启用时）必须为纯数字（如手机号），否则返回“账号格式错误”；
    • pass（令牌未启用时）必须为字母+数字组合（无中文/符号），否则返回“密码格式错误”；
    • id（帖子ID）和uid（板块ID）需对应有效，确保操作目标正确。

  5. 安全建议

    • 令牌未启用时，pass以明文传递，生产环境必须使用HTTPS协议；
    • 优先推荐启用令牌验证，减少账号密码传递频率；
    • 删除操作不可逆，建议前端添加二次确认（如“确定要删除该帖子吗？”），避免误操作。