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