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

调试工具

接口应在服务器端调用，详细说明参见服务端API。

# 接口说明

# 接口英文名

modifyJumpDomainDirectly

# 功能描述

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

# 注意事项

• 由于该接口是直接为小程序帐号配置服务器域名，所以相关的规则限制对齐普通小程序，详情可查看https://developers.weixin.qq.com/miniprogram/dev/framework/ability/domain.html.
• 由于当前有两种方式可以为第三方代开发小程序配置域名，在调用该接口之前，请先查看详细的业务逻辑说明，以免出现误操作。详情可查看https://developers.weixin.qq.com/doc/oplatform/Third-party_Platforms/2.0/product/domain.html
• 使用该接口为一个小程序配一次即可，下次审核代码不用重复set配置之前已配置过的域名 (之前通过该API配置的旧域名上线成功后不要重新set，否则需要重新发布生效，如需新增用add) ，与在mp的配置一样。 如需add，先get获取目前配置的域名，再根据业务需要新增此次需要配置的新域名，不需要再增加已存在的域名；delete前也可以先get获取下，再操作delete。

使用说明：

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

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

# 调用方式

# HTTPS 调用

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

# 第三方调用

• 调用方式以及出入参和HTTPS相同，仅是调用的token不同

• 该接口所属的权限集id为：18

• 服务商获得其中之一权限集授权后，可通过使用authorizer_access_token代商家进行调用

# 请求参数

# 返回参数

# 其他说明

# action 可选值

# 调用示例

示例说明: HTTPS请求

# 请求数据示例

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

# 返回数据示例

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

# 错误码