通用场景
根据状态、端分页查询小程序版本基础信息列表,查询结果根据版本号大小降序排列,即0.0.2在前,0.0.1在后。
公共请求参数
业务请求参数
bundle_id|端参数可选string[1,128]
【描述】端参数,用于查询多端版本,不传默认为支付宝端。如需查看小程序版本信息,则为必传。常见支持如下客户端: 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
version_status|版本状态列表可选string[1,128]
【描述】版本状态列表,用英文逗号","分割,可选;不填默认不返回。如需查看小程序版本信息,则为必传。
【枚举值】
开发中: init
审核中: auditing
审核驳回: audit_reject
【示例值】auditing
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.version.list.query&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={
"bundle_id":"com.alipay.alipaywallet",
"version_status":"auditing"
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
app_version_infos|小程序版本信息可选appversioninfo[]
【描述】版本列表,根据版本号倒叙排列,最多呈现最近 20 条。即版本号大的在前面;如果不存在任何版本,返回空列表。
bundle_id|小程序端必选string(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
app_version|版本号必选string(128)
【描述】版本号,一般为x.y.x格式,其中x、y、z都是数字
【示例值】0.2.9
version_status|版本状态必选string(32)
【描述】版本状态,可选值为:init: 开发中, auditing: 审核中, audit_reject: 审核驳回, wait_release: 待上架, base_audit_pass: 准入不可营销, gray: 灰度中, release: 已上架, offline: 已下架, audit_offline: 被强制下架;
【枚举值】
开发中: init
审核中: auditing
审核驳回: audit_reject
【示例值】auditing
create_time|版本创建时间必选date(64)
【描述】版本创建时间,精确到秒
【示例值】2019-12-11 19:00:12
version_description|版本描述可选string(500)
【描述】小程序版本描述,介绍此版本的主要变更和功能,5-500个字符。
【示例值】该版本新增了xxx功能,修复了xxx的bug,优化了用户体验。
base_audit|准入审核结果可选string(16)
【描述】准入审核结果
(提审时 audit_rule 传 base_promote 时有该字段)
【枚举值】
通过: pass
驳回: reject
【示例值】pass
promote_audit|营销审核结果可选string(16)
【描述】营销审核结果:
pass:通过
reject:驳回
(提审时 audit_rule 传 base_promote 时有该字段)
【枚举值】
通过: pass
驳回: reject
【示例值】pass
can_release|是否可上架可选string(16)
【描述】是否可上架
true:可上架
false:不可上架
(version_status 为promote_audit_reject有值)
(提审时 audit_rule 传 base_promote 时有该字段)
【示例值】true
app_versions|小程序版本列表可选string[](4096)
【描述】小程序支付宝端每个状态的最新版本号列表(历史返回值,已不推荐使用,逐渐废弃)
【示例值】["0.0.1","0.0.2"]
响应示例
正常示例
异常示例
{
"alipay_open_mini_version_list_query_response": {
"code": "10000",
"msg": "success",
"app_version_infos": [
{
"bundle_id": "com.alipay.alipaywallet",
"app_version": "0.2.9",
"version_description": "该版本新增了xxx功能,修复了xxx的bug,优化了用户体验。",
"version_status": "auditing",
"create_time": "2019-12-11 19:00:12",
"base_audit": "pass",
"promote_audit": "pass",
"can_release": "true"
}
],
"app_versions": [
"0.0.1",
"0.0.2"
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
application_type_not_miniapp | 该应用不是小程序类型 | 请使用小程序类型的应用 |
no_template_instantiate_relation | 该版本非模板实例化,无法查询构建状态 | 仅支持模板实例化的版本查询构建状态,请检查当前版本是否是模板实例化的。 |
page_size_less_zero | 不需要分页参数,根据文档修改参数后重试 |