平台身份

用户登录后异步绑定小程序或微信公众号平台身份。

绑定当前小程序平台身份

接口地址

POST /api/auth/platform/bind

接口说明

仅微信、支付宝、百度、抖音、QQ、快手小程序来源可调用。 平台由 X-Platform-Source 决定，服务端使用一次性 code 换取身份并保存； 响应不会返回 OpenID、UnionID、SessionKey 或平台密钥。

接口参数说明

Header 参数	类型	必填	说明
X-Platform-Source	integer	是	平台来源 1微信小程序 2微信公众号 3iOS 4Android 5H5 6支付宝小程序 7百度小程序 8抖音小程序 9QQ小程序 10快手小程序
X-App-Version	string	否	客户端版本号，服务端仅透传记录

Body 参数	类型	必填	说明
code	string	是	小程序登录接口返回的一次性凭证
app_id	string	否	平台应用ID，多应用场景必填

响应示例

{
  "code": 0,
  "msg": "success",
  "data": null
}

响应参数说明

成功时 data 为 null。

获取微信公众号网页授权地址

接口地址

GET /api/auth/platform/wechat_oauth_url

接口说明

仅 X-Platform-Source=2 可调用。服务端生成与当前会员、公众号配置绑定的随机 state，有效期10分钟。

接口参数说明

无请求参数。

响应示例

{
  "code": 0,
  "msg": "success",
  "data": null
}

响应参数说明

成功时 data 为 null。

完成微信公众号网页授权绑定

接口地址

POST /api/auth/platform/wechat_oauth_bind

接口说明

微信回跳后提交 code 与 state。state 只能使用一次，并通过 Redis 原子消费防止重放。

接口参数说明

Body 参数	类型	必填	说明
code	string	是
state	string	是

响应示例

{
  "code": 0,
  "msg": "success",
  "data": null
}

响应参数说明

成功时 data 为 null。