开发者社区
社区提问意见反馈
开发者钉组织
扫描二维码
加入支付宝开发者钉组织
支付产品
私域产品
小程序产品
权限集列表
搜索关键词
搜索直达
收藏
消息
小程序码
小程序服务
订单中心
小程序开发管理
接入指南
api 列表
隐私信息授权
小程序基础信息
小程序开发版本
小程序应用成员
个体账户
小程序类目
小程序二维码
代创建小程序
小程序域名
插件管理
小程序备案
生物核身
交易组件
小程序商品
支付有礼
商家粉丝群
营销产品
资金产品
会员产品
信用产品
广告产品
开发 > 服务端 > 私域产品 > 小程序产品 > 权限集列表 > 小程序开发管理 >  >  > 小程序版本列表查询
已更新
文档更新记录 >
收藏
订阅更新
我的文档
设置
接入检测
即可查看检测结果)
若有未通过的接入检测项,接口将无法调通
根据状态、端分页查询小程序版本基础信息列表,查询结果根据版本号大小降序排列,即0.0.2在前,0.0.1在后。

公共请求参数

参数类型是否必选最大长度描述示例值
app_idstring必选32
支付宝分配给开发者的应用id
2014072300007148
methodstring必选128
接口名称
alipay.open.mini.version.list.query
formatstring可选40
仅支持json
json
charsetstring必选10
请求使用的编码格式,如utf-8,gbk,gb2312等
utf-8
sign_typestring必选10
商户生成签名字符串所使用的签名算法类型,目前支持rsa2和rsa,推荐使用rsa2
rsa2
signstring必选344
商户请求参数的签名串,详见签名
详见示例
timestampstring必选19
发送请求的时间,格式"yyyy-mm-dd hh:mm:ss"
2014-07-24 03:07:50
versionstring必选3
调用的接口版本,固定为:1.0
1.0
app_auth_tokenstring可选40
biz_contentstring必选
请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

业务请求参数

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"
}' 
说明:本示例仅供参考。

公共响应参数

参数类型是否必选最大长度描述示例值
codestring必选-
网关返回码,
40004
msgstring必选-
网关返回码描述,
business failed
sub_codestring可选-
业务返回码,参见具体的api接口文档
acq.trade_has_success
sub_msgstring可选-
业务返回码描述,参见具体的api接口文档
交易已被支付
signstring必选-
签名,
dzxh8eetuahoye3w1j poiphfdxoybfunn1lket/v7p4zjdyojwea6izs6hz0ydw5cp/viufub5i0/v5wens3oyr8zredqo6d futdlhdc efyckiqhbxizgngpdpdfp1pis7bdhhzrszhbrqb7o4k3dxc aanfauu4v6zdwczo=

业务响应参数

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
不需要分页参数,根据文档修改参数后重试
内容没有解决您的问题?您还可以前往 或 寻求帮助
凯发k8官方网娱乐官方 copyright © 2022 支付宝(杭州)信息技术有限公司  | icp证浙b2-20160559
该文档对你是否有帮助?
当前页面目录
为开发者能享受更简单的协议处理逻辑、更丰富的开源工具配套、更低的接口响应时延,支付宝开放平台推出符合oas3.0规范的,助力开发体验。新版本文档请点击“查看v3版本”进行访问。