01 / CAPABILITIES
开放功能
核心接口调用手册
4 个场景覆盖登录、稳定后台 token、手机号快速验证和用户弹窗订阅消息四项核心流程。代码在自己的服务端运行,不含在线代请求,也不覆盖已开启 API 加密的完整协议。
02 / REQUIREMENTS
接入条件
- 适用主体
- 小程序开发者、自有业务技术团队、服务通知与用户系统开发者
- 接入方式
- 自有小程序 AppID 与 AppSecret / 服务端后台 access_token / wx.login 临时 code 及服务端会话
- 申请概况
- 需自有小程序账号、开发成员权限及对应接口资格;手机号能力需非个人主体认证,服务消息需用户主动订阅。
- 注册并管理自己的小程序账号,按主体、服务类目和实际上线流程完成资料、认证及审核;个人和组织能申请的能力不同。
- 在官方后台绑定开发成员,取得小程序 AppID 与 AppSecret;不使用公众号或第三方平台应用的密钥。
- 登录态由自己的服务端创建;后台 token 和 session_key 分开保存,不放进网页或小程序前端。
- 手机号需已认证非个人主体及可用额度;订阅消息需用户主动订阅对应模板,并按用户选择处理拒收。
- 本批示例使用普通 HTTPS API;若后台已启用 API 通信加密,支持该模式的接口还需适配官方加密、签名与验签,不直接套用普通 JSON 请求。
03 / GET STARTED
开通步骤
- 01
确认账号与能力范围
在微信公众平台选择小程序,核对主体、类目、成员和实际接口权限,准备 AppID。
- 02
先接通服务端登录
由客户端 wx.login 取得 code,在自己的服务器交换会话,生成业务登录态。
- 03
缓存后台凭证
以普通 stable_token 模式统一维护凭证,避免每个业务进程分别强制刷新。
- 04
按需开通手机号与通知
核对手机号额度及付费管理,配置消息模板和用户订阅流程,再验证业务接口。
04 / COSTS & LIMITS
费用、边界与测试方式
费用概况把基础接口额度、手机号组件、认证审核与云资源分开核对。
- 本批登录、后台凭证和订阅消息接口文档没有列统一按次价目;仍受账号权限、接口配额及用户授权约束,不能解释为无限调用。
- 手机号快速验证标准单价为每次组件成功调用 0.03 元;每个小程序有 1000 次体验额度,由开发版、体验版与正式版共同使用。
- 手机号扣费节点是小程序端 bindgetphonenumber 成功回调;后端换取手机号不是另一个独立免费体验流程。资源包的数量、单价和有效期按官方付费管理购买页确认。
- 手机号免费适用主体按官方细则,包括政府、非营利组织,事业单位且政务民生类目,以及公立医疗机构、学历教育(学校)类目;不扩展为所有教育或医疗应用免费。
- 微信认证是审核服务费,每次申请按当次协议费率收取,失败也不以结果免除费用。本次可读个人流程正文未给统一金额,实际主体、金额与有效期需在官方认证申请页核对。
- 云开发、云托管、服务器、存储和支付服务按各自产品规则另核对,本页不把接口文档未标价推断成整套应用零成本。
使用范围与限制
- 登录 code、手机号 code、session_key、后台 access_token 各有用途,不能互换;OpenID 也不能跨小程序直接复用。
- 手机号 code 有效 5 分钟且只可消费一次。获取手机号需真实用户同意,不支持按任意用户 ID 查询。
- 用户同意一次性订阅不等于永久营销授权;回调 success 仍应检查具体模板对应的 accept/reject 状态。
- 开发、体验与正式版本不是三份独立的免费手机号配额,测试也可能消耗付费资源。
- 官方旧产品介绍仍含个人暂不支持认证的旧表述,而客服已有个人认证流程;本文不沿用旧结论,也不将历史认证报价套用到全部主体。
如何进行开发测试
- 开发与体验:使用自己的测试小程序和测试成员;手机号配额与正式版共用。
- 正式:代码、类目及资料按官方流程审核发布;服务器 API 面向该小程序的真实资源。
- 本次仅核对官方文档,未注册账号、获取用户手机号、订阅或发送真实消息。
接入前再确认
- 旧 OpenApiDoc URL 会跳转到分类列表;本文采用实际读取的新 /dev/server/API/ 具体接口路径。
- 认证金额没有用历史统一 300 元或个人 30 元填充;手机号费率与条件读取自当前官方正文。
- 仅覆盖这四项核心场景,支付、二维码、内容安全及云服务的全部接口不在本次手册范围。
05 / OFFICIAL SOURCES
官方资料
以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。
- 01
- 02
- 03
- 04
- 05
- 06
- 07
- 08
- 09
- 10
- 11
- 12
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明