文档中心 > API类目 > 小程序API

alipay.open.mini.version.detail.query (小程序版本详情查询)

小程序版本详情查询

公共参数

请求地址:
环境 HTTPS请求地址
正式环境 https://openapi.alipay.com/gateway.do
公共请求参数:
参数 类型 是否必填 最大长度 描述 示例值
app_id String 32 支付宝分配给开发者的应用ID 2014072300007148
method String 128 接口名称 alipay.open.mini.version.detail.query
format String 40 仅支持JSON JSON
charset String 10 请求使用的编码格式,如utf-8,gbk,gb2312等 utf-8
sign_type String 10 商户生成签名字符串所使用的签名算法类型,目前支持RSA2和RSA,推荐使用RSA2 RSA2
sign String 344 商户请求参数的签名串,详见签名 详见示例
timestamp String 19 发送请求的时间,格式"yyyy-MM-dd HH:mm:ss" 2014-07-24 03:07:50
version String 3 调用的接口版本,固定为:1.0 1.0
app_auth_token String 40 详见应用授权概述
biz_content String - 请求参数的集合,最大长度不限,除公共参数外所有请求参数都必须放在这个参数中传递,具体参照各产品快速接入文档

请求参数

参数 类型 是否必填 最大长度 描述 示例值
app_version String 必须 64 小程序版本号 0.0.1

公共响应参数

参数 类型 是否必填 最大长度 描述 示例值
code String - 网关返回码,详见文档 40004
msg String - 网关返回码描述,详见文档 Business Failed
sub_code String - 业务返回码,详见文档 ACQ.TRADE_HAS_SUCCESS
sub_msg String - 业务返回码描述,详见文档 交易已被支付
sign String - 签名,详见文档 DZXh8eeTuAHoYE3w1J+POiPhfDxOYBfUNn1lkeT/V7P4zJdyojWEa6IZs6Hz0yDW5Cp/viufUb5I0/V5WENS3OYR8zRedqo6D+fUTdLHdc+EFyCkiQhBxIzgngPdPdfp1PIS7BdhhzrsZHbRqb7o4k3Dxc+AAnFauu4V6Zdwczo=

响应参数

参数 类型 是否必填 最大长度 描述 示例值
app_version String 必填 128 小程序版本号 0.0.1
app_name String 必填 20 小程序应用名称 小程序demo
app_english_name String 必填 20 小程序应用英文名称 demoexample
app_logo String 必填 512 小程序应用logo图标 http://image.aaaa.alipay.com
version_desc String 必填 500 小程序版本描述 这是一个简单的版本描述
gray_strategy String 选填 16 小程序灰度比例值,p10-10%的用户,p30-30%的用户,p50-50%的用户 p10
status String 必填 16 小程序版本状态,INIT-开发中,AUDITING-审核中,WAIT_RELEASE-审核通过,AUDIT_REJECT-审核驳回,RELEASE-已上架,GRAY-灰度中,OFFLINE-下架,ONLINE-上架 INIT
reject_reason String 选填 512 审核驳回原因 名称太宽泛
scan_result String 必填 16 安全扫描结果,HAS_RISK-安全扫描不通过,APPROVED-安全扫描通过,SCANNING-正在扫描 APPROVED
gmt_create Date 必填 32 小程序版本创建时间 2017-12-12 12:00:00
gmt_apply_audit String 选填 32 小程序版本提交审核的时间 2017-12-12 12:00:00
gmt_online String 选填 32 小程序版本上架时间 2017-12-12 12:00:00
gmt_offline String 选填 32 小程序版本下架时间 2017-12-12 12:00:00
app_desc String 必填 500 小程序应用描述 小程序demo的相关示例
gmt_audit_end String 选填 32 小程序版本审核结束时间 2017-12-12 12:00:00
service_region_type String 必填 16 小程序服务区域类型,GLOBLE-全球,CHINA-中国,LOCATION-指定区域 LOCATION
service_region_info RegionInfo [] 选填 512 小程序服务区域信息,当服务区域类型是LOCATION时,这里明确指出具体的服务区域信息
  • └ province_code
  • String
  • 选填
  • 10
  • 地址所属省份代码
  • 310000
  • └ province_name
  • String
  • 选填
  • 10
  • 地址所属省份名称
  • 浙江省
  • └ city_code
  • String
  • 选填
  • 10
  • 地址所属市代码
  • 310000
  • └ city_name
  • String
  • 选填
  • 10
  • 地址所属市名称
  • 杭州市
  • └ area_code
  • String
  • 选填
  • 10
  • 地址所属区代码
  • 311100
  • └ area_name
  • String
  • 选填
  • 10
  • 地址所属区名称
  • 余杭区
screen_shot_list String [] 必填 4196 小程序版本截图,多个截图以逗号隔开 http://image.aaa.alipay.com
app_slogan String 必填 32 小程序应用简介,一句话描述小程序功能 小程序demo简介
memo String 选填 500 小程序备注 这是一个demo示例
service_phone String 选填 15 客服电话 13110101010
service_email String 选填 128 客服邮箱 example@mail.com
mini_app_category_info_list MiniAppCategoryInfo [] 必填 128 小程序类目列表
  • └ first_category_id
  • String
  • 必填
  • 16
  • 一级类目id
  • 1234
  • └ first_category_name
  • String
  • 必填
  • 16
  • 一级类目名称
  • 生活服务
  • └ second_category_id
  • String
  • 必填
  • 16
  • 二级类目id
  • 12344
  • └ second_category_name
  • String
  • 必填
  • 16
  • 二级类目名称
  • 汽车服务
package_info_list MiniPackageInfo [] 必填 - 小程序功能包列表
  • └ package_name
  • String
  • 必填
  • 64
  • 功能包名称
  • 基础能力
  • └ package_desc
  • String
  • 选填
  • 512
  • 功能包描述
  • 这是通用能力
  • └ doc_url
  • String
  • 选填
  • 512
  • 功能包文档地址
  • http://doc.aaa.alipay.com
  • └ status
  • String
  • 选填
  • 32
  • 功能包签约状态,"valid", "已生效";"audit", "签约中";"invalid", "已失效";"none", "未签约"
  • valid
  • └ package_open_type
  • String
  • 必填
  • 16
  • 功能包开通方式,"APPLY", "申请开通";"ORDER", "签约开通";"DEFAULT", "默认开通"
  • APPLY

请求示例

  • JAVA
  • .NET
  • PHP
  • HTTP请求源码
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayOpenMiniVersionDetailQueryRequest request = new AlipayOpenMiniVersionDetailQueryRequest();
request.setBizContent("{" +
"\"app_version\":\"0.0.1\"" +
"  }");
AlipayOpenMiniVersionDetailQueryResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}

响应示例

  • JSON示例
{
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
	"alipay_open_mini_version_detail_query_response":{
		"msg":"Success",
		"gmt_create":"2017-12-12 12:00:00",
		"code":"10000",
		"app_version":"0.0.1",
		"version_desc":"这是一个简单的版本描述",
		"app_english_name":"demoexample",
		"memo":"这是一个demo示例",
		"service_region_info":[
			{
				"area_name":"余杭区",
				"city_name":"杭州市",
				"area_code":"311100",
				"city_code":"310000",
				"province_code":"310000",
				"province_name":"浙江省"
			}
		],
		"scan_result":"APPROVED",
		"app_logo":"http://image.aaaa.alipay.com",
		"service_region_type":"LOCATION",
		"app_slogan":"小程序demo简介",
		"gray_strategy":"p10",
		"reject_reason":"名称太宽泛",
		"screen_shot_list":[
			"http://image.aaa.alipay.com"
		],
		"gmt_apply_audit":"2017-12-12 12:00:00",
		"service_email":"example@mail.com",
		"app_name":"小程序demo",
		"service_phone":"13110101010",
		"package_info_list":[
			{
				"doc_url":"http://doc.aaa.alipay.com",
				"package_desc":"这是通用能力",
				"package_name":"基础能力",
				"status":"valid",
				"package_open_type":"APPLY"
			}
		],
		"gmt_online":"2017-12-12 12:00:00",
		"gmt_audit_end":"2017-12-12 12:00:00",
		"app_desc":"小程序demo的相关示例",
		"mini_app_category_info_list":[
			{
				"first_category_id":"1234",
				"first_category_name":"生活服务",
				"second_category_id":"12344",
				"second_category_name":"汽车服务"
			}
		],
		"status":"INIT",
		"gmt_offline":"2017-12-12 12:00:00"
	}
}

异常示例

  • JSON示例
{
	"sign":"ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE",
	"alipay_open_mini_version_detail_query_response":{
		"msg":"Service Currently Unavailable",
		"code":"20000",
		"sub_msg":"系统繁忙",
		"sub_code":"isp.unknow-error"
	}
}

业务错误码

错误码 错误描述 解决方案
SYSTEM_ERROR 系统繁忙 请稍后重试,或者联系技术人员解决
APPLICATION_TYPE_NOT_MINIAPP 该应用不是小程序类型 请使用小程序类型的应用
APP_VERSION_IS_BLANK 版本号为空 请输入小程序的版本号

公共错误码

返回
顶部