通用场景
小程序上架
公共请求参数
业务请求参数
app_version｜商家小程序版本号可选string[0,64]
【描述】商家小程序版本号，需为审核通过状态或灰度中版本。
【示例值】0.0.1
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
permit_registration_limit_release｜是否接受未备案受限上架可选boolean
【描述】如果该字段为true，在首次发版的小程序在备案未完成的情况下，允许小程序上架，但小程序上架后只可以上架可扫码进行使用，但不可被搜索、限制访问人数（50人/每天）、限制公域（无法进行商品、服务、营促销）、限制上架后90天不完成备案自动下架。
默认为false
【示例值】true
downgrade｜发布策略可选boolean
【描述】true - 性能优先； false - 覆盖优先（默认）
【示例值】false
常见请求示例
推荐示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.version.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"
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
无业务响应参数
响应示例
正常示例
异常示例
{
"alipay_open_mini_version_online_response": {
"code": "10000",
"msg": "success"
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| application_type_not_miniapp | 该应用不是小程序类型 | 请使用小程序类型的应用 |
| app_info_not_exist | 应用不存在 | 确认应用后重新提交 |
| app_version_is_blank | 版本号为空 | 请输入小程序的版本号 |
| can_not_online_not_gray_or_waitrelease | 版本状态不在灰度和审核通过，不允许上架 | 请输入正确的版本号 |
| can_not_online_no_promote | 指定版本不可营销，线上版本可营销，不能上架 | 退回开发，修改后重新提交审核 |
| can_not_online_without_audit | 当前版本不处于审核通过状态或者灰度状态，不能上架 | 请检查小程序状态，把小程序版本推进至审核通过状态或者灰度状态。注意如果是下架状态则不能上架。 |
| can_not_online_without_gray | 非灰度版本不能上架 | 请在灰度版本上执行上架操作 |
| can_not_online_without_registration | 当前小程序尚未完成备案，暂时无法上架 | 当前小程序尚未完成备案，暂时无法上架，详情可查看https://opendocs.alipay.com/mini/0apo6l?pathhash=e989f16a |
| developer_info_not_exist | 主体信息不存在 | 请检查主体信息 |
| merchant_not_exesit | 商户不存在 | 确认商户信息后重新提交 |
| mini_app_not_online | 小程序应用未上线 | 执行操作前确保小程序应用处于上线状态 |
| mini_app_package_info_not_exist | 小程序版本包信息不存在 | 请确保该版本包信息存在 |
| mini_app_version_iteration_exist | 小程序版本关联了迭代，请传入迭代key参数。 | 小程序版本关联了迭代，请传入迭代key参数。 |
| mini_app_version_not_exist | 版本不存在 | 请输入正确的版本号 |
| mini_app_version_not_exist | 待上架的版本不存在 | 请确保有审核通过或者灰度中的小程序版本 |