公众号订阅用户运行与绑定使用说明
查看文档来源信息
- 来源目录：
addons/sys_base/docs - 来源文件：
功能说明/公众号订阅用户运行与绑定使用说明.md
入口位置
- 微信 H5 静默授权：
/sys_base/public/wechat/silentAuth - 微信 H5 用户信息授权：
/sys_base/public/wechat/userAuth - 服务态按 OpenID 查询：
/sys_base/public/auth/getSubscribeUserByOpenid - 服务态按 UnionID 查询：
/sys_base/public/auth/getSubscribeUserByUnionid
使用前提
- 当前应用已配置正式微信接入信息。
- 服务态查询必须先通过 permanent key 换取 tempKey，再携带
X-App-Key调用。 - 请求必须带上明确
app-id，不能依赖临时猜测或匿名上下文。 - H5 登录、绑定桥接或同步链路如需写入订阅用户，必须复用统一运行时服务。
操作方法
- H5 未登录用户进入微信环境后，通过静默授权或用户信息授权进入当前应用。
- 授权成功后，后端按当前公众号用户信息写入或更新
app_wechat_subscribe_user。 - 业务侧如需把当前应用用户身份桥接到公众号订阅用户，可在服务态下按 OpenID 或 UnionID 调用正式查询接口。
- 业务侧拿到最小运行时结果后，只用于登录支撑、绑定确认和必要识别，不把这份数据扩成后台治理台账。
- 若需要批量补齐公众号订阅用户数据，由统一同步服务执行，不在 public handler 中直接拼写入逻辑。
规则说明
getSubscribeUserByOpenid和getSubscribeUserByUnionid都只允许服务态受控调用。- 两个接口都不返回完整订阅用户实体，只返回最小必要字段。
- H5 登录链路继续保留运行时实体和写入能力，不因本轮收口而删除。
- 批量同步链路会记录失败明细，并按稳定成功游标写回同步状态，下一轮从稳定游标继续重放。
- 本能力不恢复后台治理页，也不扩成系统治理或应用治理菜单项。
常见结果
- H5 用户首次授权后，会在运行时生成或更新公众号订阅用户记录。
- 已绑定用户可以通过受控查询接口拿到公众号身份桥接所需的最小结果。
- 批量同步执行后，会得到成功数量、失败数量、失败明细和稳定游标。
维护提示
- 出现查询不到订阅用户时，先核对当前
app-id、绑定关系和公众号接入配置是否一致。 - 出现同步失败时，先看失败明细中的 openid 和错误原因，再决定是否需要补偿脚本或下一轮重放。
- 若有人提出恢复治理页或恢复全量返回字段，应先回到本说明与契约说明确认是否属于正式允许范围。