# 网页授权接口调用频率提升指引

  • 公众号网页授权是微信开放平台面向公众号网页开发者提供的用户快速注册和登录的能力,开发者通过本能力提高了用户注册和登录使用公众号网页的效率。平台为了确保系统稳定,对该接口设置了并发频率的限制,建议开发者了解相关频率,根据接口文档中的调用建议合理调用该接口,详见接口文档
  • 当开发者需要对其网页进行推广或开展运营活动,现有接口调用频率未能满足需求时,可以通过本流程进行临时的接口调用频率提升。

# 1. 提额入口

# 1.1 微信公众平台

  • 登录后,在【接口权限】中找到【网页服务】---》【网页授权】(网页授权获取用户基本信息),点击“去提额”。

# 1.2 服务商平台

  • 完成入驻流程,登录后台,在【其他能力】菜单下,即可看到【能力采购】的入口。

# 2. 提额方式

# 2.1 单次提额

# 2.2 多次提额、自动提额

  • 先购买动态扩容资源包,再通过界面操作多次提额,或接口调用的方式自动化提额。

# 3. 登录与选购

# 3.1 登录微信公众平台并进入微信登录相关菜单

  • 打开微信公众平台,登录后,在【接口权限】中找到【网页服务】---》【网页授权】(网页授权获取用户基本信息),点击“去提额”,跳转至微信服务市场,购买所需提额资源包。

# 3.2 跳转后,扫码登录

# 3.2.1 跳转到微信服务商平台(或直接访问服务商平台),扫码登录

# 3.2.2 点击进入要用于集采的公司主体所对应的企业主页

# 3.3 查看、选购能力

  • 在【其他能力】菜单下,即可看到【能力采购】的入口。

# 3.4 单次提额

# 3.4.1 选购所需的提额包

  • 选择提升额度及时间周期,完成选择后点击“购买”。

# 3.4.2 设置要提额的网页应用AppID和生效时间

  • 设置提升额度的生效时间及对应提额的网页所绑定的公众号AppID,完成设置后点击“去支付”。

  • 注意:网页应用请输入正确的appid,且其主体必须与服务市场的主体一致,否则无法通过校验和完成支付;订单的生效时间包括当前时间立刻生效和未来生效时间。

# 3.4.3 检查确认相关信息

  • 进入订单结算页后,查看相关协议、检查额度、时长及生效时间等具体信息,确认无误后点击“支付”。

# 3.4.4 查看订单及开具发票

  • 通过“订单”及“发票”入口进行订单查询及发票开具的操作。

# 3.4.5回到微信公众平台,查询资源分配情况

  • 注意:此处显示的是当前生效额度;预约未来生效的订单,请前往订单详情查看。

# 3.5 购买动态扩容资源包,实现多次提额、自动提额

  • 因为企业采购的内部付款流程较长,在需要提额时再购买,有时难以满足时效性需求。为此,增加了先购买动态扩容资源包,再多次\自动提额的模式。

先购买动态扩容资源包,再给具体的公众号网页分配提额资源。

  • 有两种方式,一种是通过界面操作,一种是通过接口自动化。

# 3.5.1 通过界面操作分配

  • 注意:分配操作成功后,订单的用量数据更新会延后个3至5分钟,如果批量操作,就以提交的实际反馈为准。
# 3.5.1.1点击「分配额度」,点击「去分配」
# 3.5.1.2 选择用于分配额度的订单,选择想选择的[提额规格],点击「下一步」
# 3.5.1.3 设置要提额的公众号AppID和生效时间
  • 备注:这里只能为同主体公众号进行提额,不能为其他主体的H5提额。
# 3.5.1.4 撤销分配
  • 注意:如果分配的提额资源包未生效,可以选择撤回。如果已经生效,则不能撤回。

# 3.5.2 通过接口进行分配

  • 通过界面操作提额,仍然依赖人工操作;如果企业希望基于数据监控,实现自动化提额,可以参考以下时序图,实现自动化提额。
# 3.5.2.1 点击打开服务商平台的开发设置TAB
  • 注意:需要管理员身份登录才能查看及设置。
# 3.5.2.2 获取AppID、secret
  • 用于调起资源分配、查询接口,请保存好Appsecret。
# 3.5.2.3 设置服务商平台的消息推送的接收地址

【重要:SP_SPUID、SPUID】

SP_SPU SP_SPU ID 使用场景
动态扩容资源包 10000185 调用getConvertibleSkus时使用
SPU SPU ID 使用场景
微信登录接口——QPM提升(网页应用) 10000142 从动态扩容资源包给网页应用分配提额资源包时使用调用assignPackage时使用对应的 sku id
手机号实时验证组件 10000086
# 3.5.2.4 调接口查询可分配资源包ID

getConvertibleSkus

查询可转换的sku列表 | 微信开放文档

  • 调用方式:使用服务商平台的服务商AppID、AppSecret调用

在调分配接口时,需要输入要分配给网页应用的资源包规格,因此,需先调接口查询每个订单可分配的资源额度规格ID list。

已购买的资源包,可以按以下规格进行分配给网页应用,以下供参考,实际以接口为准。

可分配的提额资源包规格
额度 1天 3天 5天 7天 14天
5万/分钟 15,000 45,000 75,000 105,000 210,000
10万/分钟 29,000 87,000 145,000 203,000 406,000
20万/分钟 57,000 171,000 285,000 399,000 798,000
30万/分钟 86,000 258,000 430,000 602,000 1,204,000
40万/分钟 114,000 342,000 570,000 798,000 1,596,000
50万/分钟 142,000 426,000 710,000 994,000 1,988,000
# 3.5.2.5 调接口分配资源包ID

assignPackage

服务商分配资源包 | 微信开放文档

  • 调用方式:使用服务商平台的服务商AppID、AppSecret调用

入参:订单ID、要分配的小程序AppID、要分配的资源包规格id等

例如,给网页应用AppID wxabcdefghij,分配单次提额资源包每分钟10万次/分钟

# 3.5.2.6 取消分配资源包

cancelAssign

https://developers.weixin.qq.com/doc/oplatform/service_market/charge/api/charge_sp_cancel_assign.html

  • 调用方式:使用服务商平台的服务商AppID、AppSecret调用

# 4. 查询分配情况

# 4.1 查询已购资源的分配情况

queryOrderList

查询订单列表 | 微信开放文档

  • 调用方式:使用服务商平台账号的AppID、AppSecret调用

入参:spuid

返回:订单列表等

getOrder

查询订单详情 | 微信开放文档

  • 调用方式:使用服务商平台账号的AppID、AppSecret调用

入参:订单ID

返回:订单参数,支付时间、资源总量、已使用量、余量等

# 4.2 服务端消息推送

通过动态扩容资源包购买和分配的,分配的结果会发送如下消息推送,分配额度和正式提额的结果,以消息推送为准:

平台及账号 消息类型 发送内容与机制
服务商平台账号 fuwu.weixin.qq.com 资源分配结果 在分配资源后发送
取消分配结果 在取消分配资源后发送

事情详情:

# 4.2.1 资源分配结果事件

https://developers.weixin.qq.com/doc/oplatform/service_market/charge/callback/charge_sp_assign.html

# 4.2.2 取消分配结果事件

https://developers.weixin.qq.com/doc/oplatform/service_market/charge/callback/charge_sp_cancel_assign.html

# 5. 常见问题Q&A

# 5.1 采购后的退款规则?

  • 退款规则:若购买有误,且未正式开始分配资源包前,可以在支付成功后的7天内申请退款,款项将在3-5个工作日内从原支付路径返回;若资源包已经开始使用(使用1次及以上),则不能申请退款;若支付成功后超过7天,未发起退款申请,亦不能再申请退款。

# 5.2 什么情况下,分配出去给网页应用的资源包,可以逆向 (即:退回到已购资源包里)?

  • 规则:分配成功后的7天内,且该资源包未使用。

# 5.3 资源包的有效期?

  • 购买的资源包可用于分配的有效期:已购买的资源包将于支付成功后即刻生效,有效期2年,如果在2年内没有分配完毕,将到期失效。
  • 已经分配给网页应用的资源包的有效期:已经分配给网页应用的资源包,按照分配时配置的起止时间作为该资源包有效期。

关于资源包状态的枚举值说明:

1-生效中:包含了有效期内所有的包。即使用完了,也算生效中的。

2-未生效:新分配的状态显示未生效。

3-已失效:包含有效期过了和退款了的。

# 5.4 是否可以将资源包的用量预警和到期预警通过消息推送发到服务商配置的接收地址?

# 5.5 如有其他疑问,请联系客服。