用户更新签名接口文档

用于实现用户更新账号签名信息的功能，支持GET和POST两种请求方式。参数需根据后台“用户令牌是否启用”灵活选择，newsign（新签名内容）、appid（应用ID）、signature（应用签名）为必填项，同时需通过账号状态、开发者权限等前置校验。

请求地址 GET / POST

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

请求参数

参数名	位置	类型	必选	说明
appid	query	string	✅ 是	应用ID，填写从开发者中心获取的应用唯一标识
newsign	query	string	✅ 是	新签名内容，用户需更新的签名信息（非空，无特殊格式限制，建议符合应用场景需求）
signature	query	string	✅ 是	应用签名，直接从后台复制获取，无需手动生成
token	query	string	条件必选	用户令牌，仅在“用户令牌启用”时需传递；需为登录成功后获取的有效令牌，用于验证用户身份
user	query	string	条件必选	用户账号，仅在“用户令牌未启用”时需填写；格式为纯数字（如手机号），需与注册账号一致
pass	query	string	条件必选	用户密码，仅在“用户令牌未启用”时需填写；格式为字母数字组合（不可含中文），需与账号绑定的密码一致

返回示例

成功响应（签名更新成功）

{
  "code": 200,
  "msg": "success",
  "data": "更新成功"
}

失败响应（参数缺失）

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

失败响应（令牌无效）

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

失败响应（账号密码错误）

{
  "code": 404,
  "msg": "fail",
  "data": "用户账号密码错误！"
}

失败响应（状态异常）

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

失败响应（操作失败）

{
  "code": 405,
  "msg": "fail",
  "data": "更新失败：数据库操作异常"
}

返回数据结构

参数名	类型	说明
code	number	状态码：200=更新成功；204=参数缺失/错误；401=令牌无效；404=账号密码错误/账号/开发者/应用状态异常；405=账号长度校验失败/操作失败
msg	string	状态描述：success=成功，fail=失败
data	string	响应数据：返回操作结果提示或错误原因，如“更新成功”“token无效或已过期！”

代码示例

JavaScript (令牌启用)

// 1. 配置参数（用户令牌启用，需传有效token）
const appid = "your_app_id";
const newsign = "新的用户签名信息"; // 需更新的签名内容
const signature = "signature_from_backend";
const token = "valid_user_token"; // 登录获取的有效令牌

// 2. 构造POST参数
const params = new URLSearchParams({
  appid,
  newsign,
  signature,
  token
});

// 3. 发起POST请求
fetch("https://nobase.cn/api/user/update_sign", {
  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 newsign = "个人签名更新";
const signature = "signature_from_backend";
const user = "13800138000"; // 用户账号（纯数字）
const pass = "UserPass123"; // 用户密码（字母数字组合）

// 2. 拼接GET参数
const params = new URLSearchParams({ appid, newsign, signature, user, pass });
const requestUrl = `https://nobase.cn/api/user/update_sign?${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",
    "newsign": "用户签名内容",
    "signature": "signature_from_backend",
    "token": "valid_user_token"
}

# 2. 发起POST请求
url = "https://nobase.cn/api/user/update_sign"
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",
    "newsign": "更新后的签名",
    "signature": "signature_from_backend",
    "user": "13900139000",
    "pass": "UserPass456"
}

# 2. 发起GET请求
url = "https://nobase.cn/api/user/update_sign"
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、newsign、signature、token，无需传user和pass；
   • 用户令牌未启用：必须传递appid、newsign、signature、user、pass，不可同时传递token和user/pass。

2. 关键参数说明

   • newsign：为用户需更新的签名内容，接口无强制格式限制，但建议根据应用场景填写（如个人简介、备注等），长度不宜过长；
   • user（令牌未启用时）：仅支持纯数字（如手机号），长度需符合应用配置的“最短/最长账号长度”（可通过开发者后台查看）；
   • pass（令牌未启用时）：仅支持字母数字组合（无中文/特殊字符），需与账号绑定的密码完全一致，否则会返回“用户账号密码错误”。

3. 状态前置校验
   接口会自动校验以下状态，异常时返回对应提示，需提前确保：

   • 开发者账号未逾期且状态正常（非禁用）；
   • 应用处于“正常状态”（非审核中、非停用）；
   • 用户账号已注册且状态正常（非禁用）。

4. 安全与体验建议

   • 令牌未启用时，pass以明文传递，生产环境必须使用HTTPS协议，防止密码泄露；
   • 优先推荐启用用户令牌，减少账号密码的传递频率，提升接口安全性；
   • 前端可根据应用需求对newsign添加长度限制（如最大200字符），避免过长内容导致存储或展示问题。