Files
shaguabijia-app-server/docs/api/wallet-bind-wechat.md
T
OuYingJun1024 3d1e8969e6 docs: 新建 docs/integrations 集成层文档 + api 文档变薄
- 新增 docs/integrations/(README + jiguang/sms/meituan/pangle/wxpay 各一篇):
  记录各 SDK 集成的签名/验签/加解密/协议细节与踩坑(对齐 app/integrations 分层)
- docs/api 接口文档变薄: 受影响接口头部加「集成实现」链接,把验签/RSA/CPS 签名
  等重逻辑描述移到集成文档;ad-pangle-callback 验签段精简为指针
- docs/api/README 补架构说明(api 薄 / 重逻辑在 integrations)
- 后端技术实现.md 目录树补全(福利/钱包/签到/省钱/发奖端点 + crud/integrations 现状),
  pangle/wxpay 标注移入 integrations
- ad_reward_golive_checklist 路径同步 core→integrations

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-27 20:45:12 +08:00

1.0 KiB
Raw Permalink Blame History

POST /api/v1/wallet/bind-wechat — 微信授权 code 换 openid 并绑定

所属:Wallet 组(前缀 /api/v1/wallet | 鉴权:Bearer | 限流:同 IP ≤10 次/分 | ← 返回 API 索引

集成实现:见 integrations/wxpaycode 换 openid / userinfo)。

入参

字段 类型 必填 说明
code string 微信授权返回的 code(客户端 OAuth 拿到)

出参

响应 200:BindWechatResultOut

字段 类型 说明
bound bool 固定 true
wechat_nickname string | null 微信昵称
wechat_avatar_url string | null 微信头像 URL

错误码

  • 400 code 无效 / 换 openid 失败
  • 409 该微信已绑定其他账号
  • 503 微信支付未配置(wxpay_configured=false

说明

后端用 code 调微信 jscode2session(或 OAuth)换 openid 并写入 user。提现前置:必须先绑定。openid 全局唯一(DB 唯一约束),一个微信只能绑一个账号。