# 第三方平台
# 操作指南
# 入口与访问
进入「开发者平台」控制台主页面,在「我的业务」tab下可以看到当前微信账号所关联的各业务账号情况。
第三方平台账号的数量计算逻辑:当前用户作为第三方平台管理员的账号数量,加上当前用户作为开放平台管理员的开放平台下所属的第三方平台账号数量。(举个例子,用户 a 是3个第三方平台账号(所属的开放平台账号为a)的管理员,用户 a 同时也是开放平台b的管理员,而开放平台b账号下有5个第三方平台账号,那么该用户名下则具有 3+5=8个第三方平台账号的管理权限)
如果开发者当前尚未拥有「第三方平台」账号,需要点击「去创建」,前往微信开放平台创建第三方平台
# 账号登陆与权限验证
开发者首次通过控制台进入「第三方平台」详情页时,需要输入开放平台账号的密码,进行账号权限校验,校验通过后即可进入详情页面进行相关操作。
权限验证规则:
验证通过后,用户可在同一开放平台账号 下,自由切换访问其管理的所有第三方平台账号详情页,无需重复验证
访问其他开放平台账号 下的第三方平台账号详情页时,需再次进行对应账号的身份验证
开发者可以通过下拉账号选择框查看当前所关联第三方平台账号及其身份验证情况
# 基础信息
开发者可以在「基础信息」页面 查看和管理第三方平台账号的基本配置信息。
用户可以点击 「编辑」 按钮前往微信开放平台对“基础信息”或“开发密钥”进行编辑。
关于开发资料的填写详细说明可查看创建与配置第三方平台准备工作
# 平台基本信息
AppID:第三方平台的唯一标识符,这是平台账号的核心ID,用于接口调用和身份识别。AppID在创建第三方平台时由系统自动生成,不可修改。
类型:显示第三方平台的类型,当前仅支持在开发者平台管理“平台型”的第三方平台账号。
开放平台账号:显示关联的开放平台账号。
开放平台主体:显示开放平台账号的认证主体信息,包括企业名称和认证状态。
账号管理员:显示第三方平台账号的管理员信息,包括管理员头像、昵称和账号类型。每个第三方平台账号有且只有一个管理员(标记为第三方平台账号),此处也会展示该第三方平台绑定的开放平台账号主体(标记为开放平台账号)
审核状态: 显示第三方平台当前的审核状态,可能的状态包括:
未审核:尚未提交审核申请
审核中:正在进行平台审核
已通过:已通过审核,可正常使用所有功能
未通过:审核未通过,需要根据反馈进行修改后重新提交
业务配置信息
业务标签:显示第三方平台的业务分类标签,有助于商家了解服务商的专业领域。
应用官网:服务商的官方网站地址,商家可以通过此链接了解更多服务详情。
应用描述:详细描述第三方平台提供的服务内容和特色,向商家展示服务能力。
# 开发密钥配置
开发密钥 AppSecret 是第三方平台进行接口调用的重要凭证,需要妥善保管和配置。
AppSecret: 第三方平台的应用密钥,用于生成 component_access_token 和进行接口调用。AppSecret由开发者手动生成并且需要稳妥保存(平台不再保存该信息,如果丢失,则可以重置)。
API IP白名单: 为了确保接口调用的安全性,开发者可以配置允许调用接口的服务器IP地址。只有在白名单中的IP地址才能成功调用第三方平台相关接口。
配置时需要注意: 仅当开发者IP地址在该列表中时,才被允许调用相关接口。最多填写100个IP地址,以英文“;”隔开。
# 权限集
「权限集」页面展示了当前第三方平台账号下各个业务类型的权限集配置
开发者可以点击「编辑」按钮前往微信开放平台,编辑权限集信息
权限集具体的配置方式请参考权限集配置
权限集 决定了服务商可以为商家提供哪些具体的服务能力。
权限集是一个或多个接口权限的集合,只有配置了相应的权限集,才能在商家授权时获得对应的操作权限。
权限集有是否互斥之分,权限集互斥指的是该权限集只可同时授权给一个第三方平台。
权限集分类体系
权限集按照微信生态的不同产品类型进行分类,主要包括以下几个大类:
公众号与服务号权限项明细可查看公众号权限集说明
小程序与微信小店权限项明细可查看小程序权限集说明
视频号权限项明细可查看视频号权限集说明
小店带货助手权限项明细可查看小店带货助手权限集说明
具体细则请参见权限集介绍 | 微信开放文档
# 开发信息
开发信息页面是用于展示当前第三方平台应用的开发配置,包含了消息与事件接收、域名配置、安全配置等关键的开发配置信息。
开发者可以点击「编辑」按钮前往微信开放平台管理开发配置。
需要注意:
开发资料修改后,只会对“授权测试公众号/小程序列表”的授权账号生效;
需全网发布后方可对全网的授权账号生效;
开发者可以选择以下两种方式实现第三方平台后端服务:1)传统模式;2)云服务模式 。选择官方云服务并部署于微信云托管的模式,可免开发一键完成部署与配置,降低服务商基于第三方平台开展业务的成本。
具体的配置方式请参考第三方平台-开发信息配置
# 消息与事件接收配置
服务商创建的第三方平台账号,可通过“授权事件配置”接收微信官方只推送给服务商的事件信息。部分例子如下:
1、component_verify_ticket票据推送
2、授权变更通知
3、 代注册小程序事件
配置说明
授权事件接收配置: 用于接收平台推送给第三方平台帐号的消息与事件,如授权事件通知、component_verify_ticket等。
消息与事件接收配置: 用于代授权的公众号或小程序的接收平台推送的消息与事件
消息校验Token: 开发者在代替公众号或小程序接收到消息时,用此Token来校验消息。
消息加解密Key: 在代替公众号或小程序收发消息过程中使用。必须是长度为43位的字符串,只能是字母和数字。
# 域名配置
域名配置是确保第三方平台服务正常运行的重要环节,涉及多个不同用途的域名设置。
以下作简要介绍,具体请参考:创建与配置第三方平台准备工作 | 微信开放文档
授权发起页域名: 授权发起页域名指公众号/小程序在登录授权给第三方平台时的授权回调域名,在公众号/小程序进行登录授权流程中,必须从本域名内网页跳转到登录授权页,才可完成登录授权。
注意,域名不需带有 http:// 等协议内容,也不能在域名末尾附加详细的 URI 地址,严格按照类似 www.qq.com 的写法。
如果启用云开发,则会默认支持从云开发静态域名内网页跳转到登录授权页
公众号开发域名: 第三方平台在代公众号做网页授权、调用JS SDK等网页开发工作时所用的域名,以; 隔开。为了满足开发者管理需要,符合以下要求的下级域名也将生效:$APPID$.wx.abc.com($APPID$为公众号的AppID的替换符) 请下载下载校验文件,并将文件放置在域名根目录下,例如wx.qq.com,并确保可以访问该文件。 最多可以添加3个,以;隔开每月可提交修改申请3次,本月有3次机会
小程序服务器域名: 第三方平台旗下授权的小程序,只可配置本平台服务器域名列表中的域名。最多可以添加1000个服务器域名,以 “;” 隔开。每月可提交修改申请50次,本月有50次机会
小程序业务域名: 第三方平台旗下授权的小程序,只可配置本平台业务域名列表中的域名。请下载校验文件,并将文件放置在域名根目录下,例如wx.qq.com,并确保可以访问该文件。 最多可以添加300个业务域名,以;隔开
# 其他配置
授权测试账号列表: 在全网发布之前,仅该列表内公众号或服务号或小程序或视频号或带货助手账号才可进行授权,以便测试。请填写用于测试的 Appid,最多20个,以英文“;”隔开。注意,是填写原始 ID,不是AppID,否则会报错。
API 安全配置: 开发者在微信开发者平台可以查看API 安全密钥。前往微信开放平台可进行密钥配置,同时提供提供验证、随机生成及下载功能。
API 对称密钥:支持AES256和SM4算法,需提供44字节Base64编码的32字节密钥
API 非对称密钥:支持RSA和SM2算法,需通过工具生成密钥对(100-2000字符),微信平台用RSA验签。
# 代开发小程序
第三方平台-代开发小程序页面是为服务商提供的小程序代开发服务管理界面,主要用于管理代开发小程序,包括查看绑定的开发小程序以及小程序模版库。
# 代开发小程序步骤说明
第三方平台帮助旗下已授权的小程序进行代码管理时,需先开发完成小程序模板,再将小程序模板部署到旗下小程序账号中,流程包括:绑定开发小程序 -> 小程序模板的开发和上传 -> 添加到小程序模板库,获取模板ID -> 调用接口,为旗下授权的小程序部署代码。
具体流程和注意事项请参考:服务商代开发小程序 | 微信开放文档
# 已绑小程序
开发小程序 指的是服务商用于开发用途的小程序账号,该账号通常不会发布上线,仅仅用于登录微信开发者工具进行代码编写&提交。
开发者可以在控制台查看绑定的开发小程序的基础信息 ,同时进行 「解除绑定」 操作。
如果将小程序绑定为第三方平台的开发小程序,则该小程序在开发者工具的代码会默认提交到第三方平台的草稿箱 。
注意:一个第三方平台账号可绑定30个开发小程序
绑定代开发小程序的具体流程参见绑定开发小程序文档
# 小程序模板库
- 第三方代开发小程序的路径大概如下图所示,当代码提交到草稿箱之后,需要添加至模板库才可以提交代码 。因此引入了小程序模板库进行存储服务商开发的小程序代码。如果使用directCommit模式提交代码,则不需要经过模板库,详情可查看第三方小程序开发模式说明
- 开发者可以在「模板库」页面查看 草稿箱和普通模板库。
- 其他说明:小程序模板库的存储数量为200
# 开放能力
开放能力页面展示了第三方平台可以使用的各种增值服务和高级功能,这些能力可以帮助服务商为商家提供更加丰富和专业的服务。
包括:
小程序服务商组件: 用于帮助服务商在小程序内完成第三方授权、试用小程序管理等能力,提高用户体验和效率
个人主体升级版小程序: 用于帮助服务商为个人主体创建有支付能力的小程序,为服务商提供更优的服务
云服务:为服务商提供小程序、网页开发、第三方平台开发所需的数据库、存储、云函数、容器服务等云服务。
流量主代运营: 可帮助小程序代运营流量主功能进行广告变现,共享分成收入。
开发者可以点击「详情」或「申请」按钮跳转微信开放平台进行开放能力的查看或配置。