通用场景
小程序灰度上架
公共请求参数
业务请求参数
app_version｜商家小程序版本号必选string[1,64]
【描述】商家小程序版本号，需为审核通过状态的小程序版本。
【示例值】0.0.1
gray_strategy｜小程序灰度策略值必选string[1,8]
【描述】小程序灰度策略值
【枚举值】
10%的用户: p10
30%的用户: p30
50%的用户: p50
【示例值】p10
bundle_id｜小程序端可选string[1,64]
【描述】小程序客户端类型，默认为支付宝端。常见支持如下客户端：
com.alipay.alipaywallet：支付宝端；
com.alibaba.android.rimet：dingding端；
com.amap.app：高德端；
com.alibaba.ailabs.genie.webapps：天猫精灵端；
com.alipay.iot.xpaas：支付宝iot端。
如需更多端投放，请联系业务bd。
【示例值】com.alipay.alipaywallet
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.version.gray.online&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'app_auth_token=${app_auth_token}' \
-f 'biz_content={
"app_version":"0.0.1",
"bundle_id":"com.alipay.alipaywallet",
"gray_strategy":"p10"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_mini_version_gray_online_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| application_type_not_miniapp | 该应用不是小程序类型 | 请使用小程序类型的应用 |
| app_info_not_exist | 小程序不存在 | 确认小程序状态 |
| app_operator_query_error | 查询管理员错误 | 确认管理员后重试 |
| app_version_is_blank | 版本号为空 | 请输入小程序的版本号 |
| bundle_id_not_exist | 端参数不存在 | 请根据示例值输入正确的端参数 |
| can_not_gray_without_audit_pass | 不是审核通过版本或灰度版本不能灰度 | 请在审核通过版本或灰度版本上执行灰度上架操作 |
| can_not_gray_without_inner_pass | 集团内灰未通过，不能进行外灰 | 请检查集团内灰报告 |
| can_not_gray_with_risk_version | 待灰度版本不可营销，线上版本可营销不能灰度 | 重新提交审核 |
| create_gray_rule_error | 创建灰度规则失败 | 创建灰度规则失败 |
| execute_gray_failed | 执行灰度失败 | 稍后重试，如一直异常请联系凯发app官方网站的技术支持 |
| gray_strategy_is_blank | 灰度策略值为空 | 请输入灰度策略值 |
| gray_strategy_is_invalid | 灰度策略值非法 | 请输入合法的灰度策略值，目前支持p10，p30，p50 |
| gray_strategy_not_allow_reduce | 灰度比例值不能缩小 | 请输入更大的灰度比例值 |
| miniapp_version_not_exsit | 版本不存在 | 请输入正确的版本号 |
| mini_app_not_online | 小程序应用未上线 | 执行操作前确保小程序应用处于上线状态 |
| mini_app_package_info_not_exist | 小程序版本包信息不存在 | 请确保该版本包信息存在 |