用户绑定邮箱接口文档

用于实现用户账号绑定或更新邮箱的功能，支持GET和POST两种请求方式。参数需根据后台“用户令牌是否启用”灵活选择，mail（目标邮箱）、appid（应用ID）、signature（应用签名）为必填项，同时需通过账号状态、邮箱格式等前置校验。

请求地址 GET / POST

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

请求参数

参数名	位置	类型	必选	说明
appid	query	string	✅ 是	应用ID，填写从开发者中心获取的应用唯一标识
mail	query	string	✅ 是	目标绑定邮箱，需符合标准格式（如“user@example.com”），不可包含特殊字符
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": "开发者账号已逾期(1月)，请缴费后重试！"
}

失败响应（操作失败）

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

返回数据结构

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

代码示例

JavaScript (令牌启用)

// 1. 配置参数（用户令牌启用，需传有效token）
const appid = "your_app_id";
const mail = "user@example.com"; // 符合格式的目标邮箱
const signature = "signature_from_backend";
const token = "valid_user_token"; // 登录获取的有效令牌

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

// 3. 发起POST请求
fetch("https://nobase.cn/api/user/bind_mail", {
  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 mail = "newuser@example.com";
const signature = "signature_from_backend";
const user = "13800138000"; // 用户账号（纯数字）
const pass = "UserPass123"; // 用户密码（字母数字组合）

// 2. 拼接GET参数
const params = new URLSearchParams({ appid, mail, signature, user, pass });
const requestUrl = `https://nobase.cn/api/user/bind_mail?${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",
    "mail": "user1@example.com",
    "signature": "signature_from_backend",
    "token": "valid_user_token"
}

# 2. 发起POST请求
url = "https://nobase.cn/api/user/bind_mail"
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",
    "mail": "user2@example.com",
    "signature": "signature_from_backend",
    "user": "13900139000",
    "pass": "UserPass456"
}

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

2. 关键格式校验

   • mail：需符合标准邮箱格式（如“xxx@xxx.com”），接口会拒绝含特殊字符、无“@”符号等非法格式；
   • user（令牌未启用时）：仅支持纯数字（如手机号），长度需符合应用配置的“最短/最长账号长度”；
   • pass（令牌未启用时）：仅支持字母数字组合（无中文/特殊字符），需与账号绑定的密码完全一致。

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

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

4. 安全与体验建议

   • 令牌未启用时，pass以明文传递，生产环境必须使用HTTPS协议，防止密码泄露；
   • 优先推荐启用用户令牌，减少账号密码的传递频率，提升接口安全性；
   • 前端可提前通过正则（如 /^[a-zA-Z0-9._%+-]+@[a-zA-Z0-9.-]+\.[a-zA-Z]{2,}$/）校验邮箱格式，减少无效接口请求。