用户签到接口

用于实现用户每日签到功能，支持GET和POST两种请求方式。参数需根据后台是否启用“用户令牌校验”灵活选择：启用则仅传token，无需传user和pass；未启用则需传user和pass，应用签名直接从后台获取。

请求地址 GET / POST

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

请求参数

参数名	位置	类型	必选	说明
appid	query	string	✅ 是	应用ID，填写从开发者中心获取的应用唯一标识
token	query	string	❌ 否	用户令牌，仅在后台应用配置启用“用户令牌校验”时需传递；启用后无需再传user和pass
user	query	string	条件必选	用户账号，仅在未启用“用户令牌校验”时需填写
pass	query	string	条件必选	用户密码，仅在未启用“用户令牌校验”时需填写
signature	query	string	✅ 是	应用签名，直接从后台复制获取，无需手动生成

返回示例

成功响应（当日首次签到）

{
  "code": 200,
  "msg": "success",
  "data": "签到成功！"
}

返回数据结构

参数名	类型	说明
code	number	状态码：200=请求成功（含已签到），400=参数错误/身份验证失败，500=系统错误
msg	string	状态描述：success=成功，fail=失败
data	string	响应数据：code=200时返回签到结果提示，code≠200时返回具体错误提示

代码示例

JavaScript (启用令牌)

// 1. 配置参数（启用令牌校验：传token，无需传user和pass）
const appid = "your_app_id"; // 替换为实际应用ID
const token = "valid_user_token"; // 替换为登录获取的有效令牌
const signature = "signature_from_backend"; // 替换为后台复制的应用签名

// 2. 拼接GET参数
const params = new URLSearchParams({
  appid,
  token,
  signature
});

// 3. 发起GET请求
const requestUrl = `https://nobase.cn/api/user/signin?${params.toString()}`;
fetch(requestUrl)
  .then(response => {
    if (!response.ok) throw new Error(`HTTP错误：${response.status}`);
    return response.json();
  })
  .then(res => {
    console.log("签到结果：", res.data); // 示例输出："签到成功！" 或 "今日已签到..."
  })
  .catch(error => console.error("请求异常：", error));

JavaScript (未启用令牌)

// 1. 配置参数（未启用令牌校验：传user和pass，无需传token）
const appid = "your_app_id";
const user = "user_account"; // 替换为用户注册账号
const pass = "user_password"; // 替换为用户注册密码
const signature = "signature_from_backend";

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

// 3. 发起POST请求
fetch("https://nobase.cn/api/user/signin", {
  method: "POST",
  body: params,
  headers: {
    "Content-Type": "application/x-www-form-urlencoded"
  }
})
  .then(response => response.json())
  .then(res => {
    console.log("签到结果：", res.data);
  })
  .catch(error => console.error("请求异常：", error));

Python (启用令牌)

import requests

# 1. 配置参数
appid = "your_app_id"
token = "valid_user_token"
signature = "signature_from_backend"

# 2. 构造GET参数
params = {
    "appid": appid,
    "token": token,
    "signature": signature
}

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

Python (未启用令牌)

import requests

# 1. 配置参数
appid = "your_app_id"
user = "user_account"
passwd = "user_password"
signature = "signature_from_backend"

# 2. 构造POST参数
params = {
    "appid": appid,
    "user": user,
    "pass": passwd,
    "signature": signature
}

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

注意事项

1. 参数选择规则：后台启用“用户令牌校验”后，仅需传递 appid、token、signature；未启用时，需传递 appid、user、pass、signature，不可同时传递 token 和 user/pass。
2. 签到频率限制：接口默认限制“每日仅可签到1次”，重复签到会返回“今日已签到”提示，无需额外处理逻辑。
3. 签名与令牌有效性：signature 需与后台一致，避免字符缺失或多余空格；token 需在有效期内，过期后需引导用户重新登录。
4. 请求方式兼容性：GET和POST方式均可使用，前端可根据项目习惯选择；推荐POST方式，减少参数在URL中的暴露（尤其未启用令牌校验时）。
5. 安全提示：未启用令牌校验时，pass 以明文传递，生产环境需使用HTTPS协议；优先推荐启用令牌校验，提升接口安全性。