# 代开发的小程序域名配置说明

为了满足不同服务商代开发小程序的业务模式,现支持两种方式为代开发的小程序配置服务器域名和业务域名。

基础说明

  • 「代开发小程序」:指的是该小程序的「开发权限集」(即权限集 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