修改 webview 域名V2
收藏接口说明
该接口用于第三方小程序应用为授权小程序修改业务域名（webview 域名）。
使用限制
- action 不是 get 时，入参中的 webview 域名需要在第三方小程序应用的 webview 域名列表内或者是第三方小程序应用 webview 域名的子域名。
- 接口会对入参中的域名进行去重处理，所以有时候即使传了参数还是可能会报 40026（至少传递一个要被操作的域名类型）错误。
基本信息
| 名称 | 描述 |
|---|---|
| HTTP URL | https://open.douyin.com/api/apps/v2/domain/modify_webview_domain/ |
| HTTP Method | POST |
| Scope | ma.domain |
| 权限要求 | 授权小程序授予基本信息设置权限 |
请求参数
请求头
access-token必填String
示例：isvact.0801121846735352506a356a6
content-type必填String
示例：application/json
固定值"application/json"
Body展开全部子属性
action必填String
示例：get
add 添加，delete 删除，set 覆盖，get 获取
webviewList
action 为 get 可不填
展开子属性
请求示例
curl --location 'https://open.douyin.com/api/apps/v2/domain/modify_webview_domain/' \ --header 'access-token: isvact.15exxxxxxu3UEynUKzvi0b2Kugshu83cqR7' \ --header 'Content-Type: application/json' \ --data '{ "action": "add", "webview": ["www.xxx.com"] }'
响应参数
Body展开全部子属性
err_msg必填String
错误描述
err_no必填Int32
示例：0
错误码
log_id必填String
示例：202401171146249E93BBEB2833B467B53D
标识请求的唯一id
dataStruct
展开子属性
响应示例
正常响应示例异常响应示例
{ "err_msg": "", "err_no": 0, "log_id": "202401171146249E93BBEB2833B467B53D" }
切换单列布局错误码
| HTTP 状态码 | 错误码 | 错误码描述 | 排查建议 |
|---|---|---|---|
| 200 | 40001 | 参数错误 | |
| 200 | 40023 | 域名不是第三方小程序应用已设置的域名或子域名 | |
| 200 | 40024 | 域名数量超过限制，最多设置 20 个 | |
| 200 | 40025 | 该授权小程序不是企业小程序，不支持调用 webview 域名相关接口 | |
| 200 | 40026 | 至少传递一个要被操作的域名类型 | |
| 200 | 40027 | 域名不能包含协议，不能是 IP 地址，不支持端口 | |
| 200 | 40028 | 无法删除域名，请确认授权小程序已经添加了域名 |
