# 快速设置小程序业务域名

  • 该接口用于配置小程序业务域名,不再需要先将域名配置到第三方平台,可通过该接口直接进行配置到授权小程序。但是,配置成功后,需要提交代码或者发布上线后才会真正生效通过该接口配置的域名
  • 使用之前请详细查看代开发的小程序域名配置说明
  • 使用过程中如遇到问题,可在开放平台服务商专区发帖交流。

注意:

使用说明:

1、由于一个小程序帐号的域名可以通过公众平台配置、可以通过setwebviewdomain接口配置,也可以通过改接口进行配置;但如果是通过modify_domain接口配置的域名会在发布环节做一些处理

2、因此,为了方便开发者更好理解不同渠道配置的域名最后生效的效果是如何的,可通过get_effective_webviewdomain接口获取“effective_webviewdomain”信息,确保无误之后再进行代码发布操作。

# 请求地址

POST https://api.weixin.qq.com/wxa/setwebviewdomain_directly?access_token=ACCESS_TOKEN

# 请求参数说明

参数 类型 必填 说明
access_token string 第三方平台接口调用令牌authorizer_access_token
action string 操作类型,如果没有指定 action,则默认将第三方平台登记的小程序业务域名全部添加到该小程序
webviewdomain string array 小程序业务域名,当 action 参数是 get 时不需要此字段

# action 可选值

可选值 说明
add 添加
delete 删除
set 覆盖
get 获取

POST 数据示例:

{
  "action": "add",
  "webviewdomain": ["https://www.qq.com", "https://m.qq.com"]
}

# 返回参数说明

参数 类型 说明
errcode number 返回码
errmsg string 错误信息

返回结果示例:

{
  "errcode": 0,
  "errmsg": "ok"
}

# 返回码说明

返回码 说明
0 成功
业务域名无更改,无需重复设置
业务域名数量超过限制,最多可以添加200个业务域名
个人小程序不支持调用 setwebviewdomain 接口
其他错误码 请查看全局错误码