用户反馈提交

用于实现用户提交反馈信息（含标题、内容等）的功能，支持GET和POST两种请求方式。参数需根据后台“用户令牌是否启用”灵活选择，title（反馈标题）、content（反馈内容）为必填项，应用签名直接从后台获取，同时需校验账号状态、提交频率等前置条件。

请求地址 GET / POST

https://nobase.cn/api/user/feedback

请求参数

参数名	位置	类型	必选	说明
appid	query	string	✅ 是	应用ID，填写从开发者中心获取的应用唯一标识
title	query	string	✅ 是	反馈标题，需填写反馈的核心主题（非空）
content	query	string	✅ 是	反馈内容，需详细描述反馈的问题或建议（非空）
signature	query	string	✅ 是	应用签名，直接从后台复制获取，无需手动生成
token	query	string	条件必选	用户令牌，仅在“用户令牌启用”时需传递；需为登录成功后获取的有效令牌，用于验证反馈提交者身份
user	query	string	条件必选	提交者账号，仅在“用户令牌未启用”时需填写；格式为纯数字（如手机号）
pass	query	string	条件必选	提交者密码，仅在“用户令牌未启用”时需填写；格式为字母数字组合（不可含中文），需与账号绑定的密码一致
contact	query	string	❌ 否	联系方式（可选），如手机号、邮箱等，用于反馈回复

返回示例

成功响应（反馈提交成功）

{
  "code": 200,
  "msg": "success",
  "data": "反馈成功"
}

失败响应（参数错误）

{
  "code": 204,
  "msg": "fail",
  "data": "接口参数错误：缺少token（用户令牌启用时需提供）！"
}

失败响应（令牌/账号异常）

{
  "code": 401,
  "msg": "fail",
  "data": "token无效或已过期！"
}

失败响应（提交频繁）

{
  "code": 405,
  "msg": "fail",
  "data": "反馈频繁：请于30秒后再提交！"
}

失败响应（状态异常）

{
  "code": 404,
  "msg": "fail",
  "data": "开发者账号已逾期(1天)，请缴费后重试！"
}

返回数据结构

参数名	类型	说明
code	number	状态码：200=提交成功；204=参数缺失/错误；401=令牌无效；404=账号/开发者/应用状态异常；405=提交频繁/操作失败
msg	string	状态描述：success=成功，fail=失败
data	string	响应数据：返回操作结果提示或错误原因，如“反馈成功”“反馈频繁：请于30秒后再提交！”

代码示例

JavaScript (令牌启用)

// 1. 配置参数（用户令牌启用，需传有效token）
const appid = "your_app_id";
const title = "功能建议"; // 反馈标题
const content = "希望增加余额明细查询功能"; // 反馈内容
const signature = "signature_from_backend";
const token = "valid_user_token"; // 提交者的有效令牌
const contact = "13800138000"; // 可选联系方式

// 2. 构造POST参数
const params = new URLSearchParams({
  appid,
  title,
  content,
  signature,
  token,
  contact // 可选参数，可省略
});

// 3. 发起POST请求
fetch("https://nobase.cn/api/user/feedback", {
  method: "POST",
  body: params,
  headers: { "Content-Type": "application/x-www-form-urlencoded" }
})
.then(res => res.json())
.then(res => {
  res.code === 200 
    ? console.log("反馈提交成功：", res.data) 
    : console.error("反馈提交失败：", res.data);
})
.catch(err => console.error("请求异常：", err));

JavaScript (令牌未启用)

// 1. 配置参数（用户令牌未启用，需传user和pass）
const appid = "your_app_id";
const title = "bug反馈";
const content = "转账后余额显示异常";
const signature = "signature_from_backend";
const user = "13700137000"; // 提交者账号（纯数字）
const pass = "UserPass123"; // 提交者密码（字母数字组合）

// 2. 拼接GET参数
const params = new URLSearchParams({ 
  appid, 
  title, 
  content, 
  signature, 
  user, 
  pass 
});
const requestUrl = `https://nobase.cn/api/user/feedback?${params.toString()}`;

// 3. 发起GET请求
fetch(requestUrl)
.then(res => res.json())
.then(res => {
  res.code === 200 
    ? console.log("反馈提交成功：", res.data) 
    : console.error("反馈提交失败：", res.data);
})
.catch(err => console.error("请求异常：", err));

Python (令牌启用)

import requests

# 1. 配置参数
params = {
    "appid": "your_app_id",
    "title": "界面优化建议",
    "content": "首页布局希望更简洁",
    "signature": "signature_from_backend",
    "token": "valid_user_token",
    "contact": "example@mail.com"  # 可选
}

# 2. 发起POST请求
url = "https://nobase.cn/api/user/feedback"
try:
    res_data = requests.post(url, data=params, timeout=5).json()
    print(f"结果：{res_data['data']}")
except requests.exceptions.RequestException as e:
    print(f"请求异常：{str(e)}")

Python (令牌未启用)

import requests

# 1. 配置参数
params = {
    "appid": "your_app_id",
    "title": "登录问题",
    "content": "验证码收不到",
    "signature": "signature_from_backend",
    "user": "13900139000",
    "pass": "UserPass456"
}

# 2. 发起GET请求
url = "https://nobase.cn/api/user/feedback"
try:
    res_data = requests.get(url, params=params, timeout=5).json()
    print(f"结果：{res_data['data']}")
except requests.exceptions.RequestException as e:
    print(f"请求异常：{str(e)}")

注意事项

1. 参数选择规则

   • 用户令牌启用：仅需传递appid、title、content、signature、token，可选传contact，无需传递user和pass；
   • 用户令牌未启用：需传递appid、title、content、signature、user、pass，可选传contact，不可同时传递token和user/pass。

2. 关键参数约束

   • title和content：不可为空，建议title简洁（如“功能建议”“bug反馈”），content详细描述问题；
   • user（令牌未启用时）：格式为纯数字，长度需符合应用配置的“账号长度范围”（最短/最长限制）；
   • pass（令牌未启用时）：仅支持字母数字组合（无中文/特殊字符），需与账号绑定的密码一致。

3. 提交频率限制
   接口限制同一用户60秒内只能提交1次反馈，频繁提交会返回“反馈频繁：请于X秒后再提交！”，建议前端添加倒计时提示。

4. 状态前置检查
   接口会校验以下状态，异常时返回对应提示：

   • 开发者账号是否逾期、状态是否正常；
   • 应用是否处于“正常状态”（非审核中、非停用）；
   • 提交者账号状态是否正常（非异常/禁用）。

5. 安全提示

   • 令牌未启用时，pass以明文传递，生产环境必须使用HTTPS协议；
   • 优先推荐启用用户令牌，减少账号密码暴露风险；
   • contact为可选参数，若需接收反馈回复，建议填写有效联系方式（如手机号/邮箱）。