📖 接口概述

本文档描述 鑫宜家 开放平台的对外接口，供微信小程序、移动 App 及第三方系统对接使用。

🔐 鉴权方式

除公开接口外，其余接口需在请求头携带 Authorization: Bearer {token}。

base64(member_id + "|" + timestamp + "|" + sign)
sign = HMAC-SHA256(member_id + "|" + timestamp, app.key)

⚠️ 错误码

📱 微信小程序登录

请求参数

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "token": "base64(member_id|timestamp|sign)",
    "expires_in": 7200,
    "member_no": "XYJ2026000001",
    "nickname": "微信用户",
    "avatar": "https://...",
    "session_key": "xxx"
  }
}

错误情况

• 400：code 为空
• 503：后台未配置微信小程序 AppID / AppSecret
• 401：微信返回错误（如 code 无效或已使用）
• 403：账号被禁用

📲 绑定手机号

请求参数

响应示例

{
  "code": 0,
  "msg": "绑定成功",
  "data": { "mobile": "13800138000" }
}

✅ 验证 Token

请求参数

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "member_id": 1,
    "member_no": "XYJ2026000001",
    "nickname": "测试用户"
  }
}

🔄 刷新 Token

请求参数

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "token": "新的base64令牌",
    "expires_in": 7200
  }
}

⚙️ 开放平台配置

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "login_methods": {
      "password": true,
      "sms": true,
      "member_no": true,
      "wx": true,
      "alipay": false,
      "unionpay": false,
      "face": false,
      "fingerprint": false
    },
    "platforms": {
      "wechat": true,
      "alipay": false,
      "unionpay": false,
      "sms": false
    },
    "site_name": "鑫宜家",
    "site_logo": "https://tuan.xin1jia.com/static/picture/logo-1.png"
  }
}

📋 登录方式列表

响应示例

{
  "code": 0,
  "msg": "ok",
  "data": {
    "methods": [
      {"name": "password",   "label": "账号密码登录", "icon": "🔑"},
      {"name": "sms",        "label": "短信验证码登录", "icon": "📱"},
      {"name": "member_no",  "label": "用户ID登录",   "icon": "🪪"},
      {"name": "wx",         "label": "微信登录",     "icon": "💬"}
    ]
  }
}