开发与云服务 / Weixin Mini Program APIs

微信小程序

面向开发者自己拥有并获授权的小程序,介绍登录身份、后台凭证、手机号快速验证和弹窗订阅消息的接入。小程序不是公众号,不能混用两类账号的 AppID、用户标识或授权凭证;支付产品另按微信支付规则申请。

微信小程序登录OpenID手机号验证订阅消息
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

开通步骤

  1. 01

    确认账号与能力范围

    在微信公众平台选择小程序,核对主体、类目、成员和实际接口权限,准备 AppID。

  2. 02

    先接通服务端登录

    由客户端 wx.login 取得 code,在自己的服务器交换会话,生成业务登录态。

  3. 03

    缓存后台凭证

    以普通 stable_token 模式统一维护凭证,避免每个业务进程分别强制刷新。

  4. 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

官方资料

以下资料用于核对本页内容。申请与使用时,请以对应接口的最新规则为准。

  1. 01
    注册、主体与开发成员介绍已核对官方资料 · 2026-10-15
  2. 02
    个人微信认证流程及审核费用性质已核对官方资料 · 2026-10-15
  3. 03
    客户端与服务端登录流程已核对官方资料 · 2026-10-15
  4. 04
    code2Session 当前请求与错误码已核对官方资料 · 2026-10-15
  5. 05
    稳定版后台凭证已核对官方资料 · 2026-10-15
  6. 06
    手机号快速验证资格与费用已核对官方资料 · 2026-10-15
  7. 07
    手机号兑换请求已核对官方资料 · 2026-10-15
  8. 08
    用户弹窗订阅消息流程已核对官方资料 · 2026-10-15
  9. 09
    客户端请求订阅与回调已核对官方资料 · 2026-10-15
  10. 10
    服务端发送订阅消息已核对官方资料 · 2026-10-15
  11. 11
    服务端 API 加密与签名已核对官方资料 · 2026-10-15
  12. 12
    小程序管理后台入口官方入口 · 细则待复核 · 2026-10-15
官方文档核对,未进行接口实测
最近核验 2026-10-15 · 查看核验说明