微信开放平台接入说明

本页用于微信开放平台开发者配置、审核说明和内部技术交接。页面不展示 AppSecret、API Token 等敏感配置。

Android 应用配置

应用名称 每日足迹
应用包名 com.example.myapplication
应用签名 请使用正式发布包 release keystore 的证书 MD5，小写且不带冒号。调试环境签名只用于本机开发测试，不能作为正式上架签名。
微信回调入口 com.example.myapplication.wxapi.WXEntryActivity
当前接入能力 微信一键登录与账号绑定。应用暂不在公开页面展示微信 AppSecret。

微信登录流程

1

用户点击微信一键登录

Android 客户端通过微信 OpenSDK 发起授权请求，请求范围为用户授权登录所需信息。

2

微信客户端回调 WXEntryActivity

授权成功后，微信客户端将临时 code 回调到 WXEntryActivity，客户端只临时保存 code，不保存微信密码。

3

后端换取微信身份

客户端把 code 发送到后端 /api/v1/auth/wechat，后端使用服务器端配置的 AppID 与 AppSecret 换取 openid/unionid。

4

创建或绑定应用账号

如果该微信身份首次使用，系统要求输入管理员推荐码后创建并绑定账号；已有账号则直接返回应用 accountToken。

后端接口摘要

微信登录 POST /api/v1/auth/wechat，参数包括 deviceId、code，首次绑定时附带 inviteCode。
账号登录 POST /api/v1/auth/login，账号密码登录。
账号注册 POST /api/v1/auth/register，注册需管理员推荐码。
足迹同步 POST /api/v1/sync，上传轨迹点和收藏点。
上线前核对：微信开放平台中登记的 Android 包名和应用签名必须与正式安装包完全一致；如果更换 release keystore，需要同步更新微信开放平台应用签名。