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

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

基础说明:

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