通用场景
小程序添加域白名单
公共请求参数
业务请求参数
safe_domain｜服务器域名白名单必选string[1,100]
【描述】服务器域名白名单。支付宝小程序在http请求、上传文件等场景只能与域名白名单中的域名进行通讯 。
新添加域白名单后需重新上传应用版本（模板模式下小程序模板及商家应用都需重新上传、实例化版本）才会生效。老版本应用继续使用老版本名单。
每个应用最多可添加30个 url。
【示例值】example.com
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.safedomain.create&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"safe_domain":"example.com"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_mini_safedomain_create_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| anti_phishing_exist | 域白名单存在防钓鱼链接 | 请重新输入域白名单 |
| application_type_not_miniapp | 应用类型不是小程序 | 请使用小程序类型的应用 |
| illegal_params | 参数非法 | 请根据文档仔细检查入参，确保需要的参数均已传入且格式内容均正确 |
| invalid_safe_domain | 域白名单包含非法字符 | 请重新输入域白名单 |
| safedomain_exceed_length | 域白名单长度超出限制 | 请保证域白名单长度不超出限制 |
| safedomain_exsit | 域白名单已经存在 | 请重新输入域白名单 |
| safedomain_forbid | 不允许添加阿里巴巴集团域名单 | 请别添加阿里巴巴集团域名单 |
| safedomain_voer_limit | 域白名单个数超过限制 | 域白名单个数不能超出5个 |
| safe_domain_is_blank | 域白名单为空 | 请输入域白名单 |