# 代开发的小程序域名配置说明
为了满足不同服务商代开发小程序的业务模式,现支持两种方式为代开发的小程序配置服务器域名和业务域名。
基础说明
- 「代开发小程序」:指的是该小程序的「开发权限集」(即权限集 ID 为 18 的权限)授权给第三方服务商进行代开发。
- 此类小程序不可在微信公众平台配置服务器域名和业务域名,只能由第三方服务商通过接口进行配置。服务商可依据实际业务情况,选择不同的 API 进行配置。
接口列表
| 接口代号 | 接口名称 | 接口地址 |
|---|---|---|
| 接口 A | 配置小程序服务器域名 | modify_domain |
| 接口 B | 配置小程序业务域名 | setwebviewdomain |
| 接口 C | 快速配置小程序服务器域名 | modify_domain_directly |
| 接口 D | 获取业务域名校验文件 | get_webviewdomain_confirmfile |
| 接口 E | 快速配置小程序业务域名 | setwebviewdomain_directly |
| 接口 F | 设置第三方平台服务器域名 | modify_wxa_server_domain |
| 接口 G | 获取第三方平台业务域名校验文件 | get_domain_confirmfile |
| 接口 H | 设置第三方平台业务域名 | modify_wxa_jump_domain |
| 接口 I | 获取发布后生效服务器域名列表 | get_effective_domain |
| 接口 J | 获取发布后生效业务域名列表 | get_effective_webviewdomain |
# 方式一
通过该方式配置小程序域名,需先将域名添加到第三方平台。
- 如果某小程序在授权给服务商代开发之前已经配置了域名
a.com,授权给服务商之后,若服务商没有将a.com配置至第三方平台,则在小程序发布时会将a.com删除。 - 服务商将
b.com添加至第三方平台,且通过接口配置给小程序,提交体验版一切正常;如果在提交发布之前服务商又从第三方平台删除了b.com,那么该小程序发布时也会将b.com删除,从而导致线上版本访问b.com失败。请注意避免此类情况。 - 更多规则细节可查看对应接口文档。
常用场景
为商家提供模板小程序开发服务的服务商推荐选用此种模式。服务商只需将服务商的域名配置至第三方平台,即可通过接口将域名添加到无数个商家小程序中。
涉及接口
| 接口代号 | 接口名称 | 接口地址 |
|---|---|---|
| 接口 A | 配置小程序服务器域名 | modify_domain |
| 接口 B | 配置小程序业务域名 | setwebviewdomain |
| 接口 F | 设置第三方平台服务器域名 | modify_wxa_server_domain |
| 接口 G | 获取第三方平台业务域名校验文件 | get_domain_confirmfile |
| 接口 H | 设置第三方平台业务域名 | modify_wxa_jump_domain |
# 方式二
通过该方式配置小程序域名,无需先将域名添加到第三方平台,可通过下方接口直接为授权小程序配置域名。通过此方式,一个域名只可添加至 100 个主体小程序(即使该域名已通过方式一添加至第三方平台,使用方式二时仍然受此限制)。详情可查看小程序服务器域名说明和小程序业务域名说明。
更多规则细节可查看对应接口文档。
常用场景
为商家提供个性化小程序开发服务的服务商推荐选用此种模式,因为可为每个商家小程序配置不一样的域名,即商家可自由选择需配置的域名。
涉及接口
| 接口代号 | 接口名称 | 接口地址 |
|---|---|---|
| 接口 C | 快速设置小程序服务器域名 | modify_domain_directly |
| 接口 D | 获取业务域名校验文件 | get_webviewdomain_confirmfile |
| 接口 E | 快速配置小程序业务域名 | setwebviewdomain_directly |
# 其他补充
小程序域名可通过公众平台配置,也可通过上方两种方式配置。为了方便开发者知晓不同方式配置的域名最终生效结果,可通过下方两个接口获取。建议在小程序发布前通过接口确认上线后生效的域名无误,避免发布后生效的域名与预期不符而影响线上业务。此外,尽量不要混合使用不同的方式配置同一个小程序的域名。
| 接口代号 | 接口名称 | 接口地址 |
|---|---|---|
| 接口 I | 获取发布后生效服务器域名列表 | get_effective_domain |
| 接口 J | 获取发布后生效业务域名列表 | get_effective_webviewdomain |