通用场景
小程序版本详情查询
公共请求参数
业务请求参数
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
常见请求示例
默认示例
curl 'https://openapi.alipay.com/gateway.do?charset=utf-8&method=alipay.open.mini.version.detail.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={
"app_version":"0.0.1",
"bundle_id":"com.alipay.alipaywallet"
}'
说明:本示例仅供参考。
公共响应参数
业务响应参数
app_version|小程序版本号可选string(128)
【描述】小程序版本号
【示例值】0.0.1
app_name|小程序应用名称可选string(30)
【描述】小程序应用名称
【示例值】小程序demo
app_english_name|小程序应用英文名称可选string(64)
【描述】小程序应用英文名称
【示例值】demoexample
app_logo|小程序应用logo图标可选string(512)
【描述】小程序应用logo图标
【示例值】http://image.aaaa.alipay.com
version_desc|小程序版本描述可选string(500)
【描述】小程序版本描述
【示例值】这是一个简单的版本描述
gray_strategy|小程序灰度比例值可选string(1024)
【描述】小程序灰度比例值,p10-10%的用户,p30-30%的用户,p50-50%的用户
【示例值】p10
status|小程序版本状态可选string(16)
【描述】小程序版本状态,init-开发中,auditing-审核中,wait_release-待上架,base_audit_pass-准入不可营销,audit_reject-审核驳回,release-已上架,gray-灰度中,offline-已下架,audit_offline-已被强制下架
【示例值】init
reject_reason|审核驳回原因可选string(2048)
【描述】审核驳回原因
【示例值】名称太宽泛
scan_result|安全扫描结果可选string(16)
【描述】安全扫描结果,true-安全扫描通过,false-安全扫描不通过,nan-扫描中
【示例值】true
gmt_create|小程序版本创建时间可选date(32)
【描述】小程序版本创建时间
【示例值】2017-12-12 12:00:00
gmt_apply_audit|小程序版本提交审核的时间可选string(32)
【描述】小程序版本提交审核的时间,格式为yyyy-mm-dd hh:mm:ss
【示例值】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)
【描述】小程序版本审核结束时间,格式为yyyy-mm-dd hh:mm:ss
【示例值】2017-12-12 12:00:00
service_region_type|小程序服务区域类型可选string(16)
【描述】小程序服务区域类型
【枚举值】
全球: globle
中国: china
指定区域: location
【示例值】location
service_region_info|小程序服务区域信息可选regioninfo[]
【描述】小程序服务区域信息,当服务区域类型是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(32)
【描述】客服电话
【示例值】13110101010
service_email|客服邮箱可选string(128)
【描述】客服邮箱
【示例值】example@mail.com
mini_app_category_info_list|小程序类目列表可选miniappcategoryinfo[]
【描述】小程序类目列表
first_category_id|一级类目id必选string(16)
【描述】一级类目id
【示例值】xs1020
first_category_name|一级类目名称必选string(16)
【描述】一级类目名称
【示例值】购物
second_category_id|二级类目id必选string(16)
【描述】二级类目id
【示例值】xs2167
second_category_name|二级类目名称必选string(64)
【描述】二级类目名称
【示例值】零售门店
third_category_id|三级类目id可选string(16)
【描述】三级类目id,可空
【示例值】xs3175
third_category_name|三级类目名称可选string(64)
【描述】三级类目名称,可空
【示例值】服饰箱包门店
package_info_list|小程序功能包列表可选minipackageinfo[]
【描述】小程序功能包列表
package_name|功能包名称必选string(1024)
【描述】功能包名称
【示例值】小程序基础功能包
package_open_type|功能包开通方式必选string(64)
【描述】功能包开通方式
【枚举值】
申请开通: apply
签约开通: order
默认开通: default
【示例值】apply
package_desc|功能包描述可选string(1024)
【描述】功能包描述
【示例值】通用能力
doc_url|功能包文档地址可选string(1024)
【描述】功能包文档地址
【示例值】http://doc.aaa.alipay.com
status|功能包签约状态可选string(64)
【描述】功能包签约状态
【枚举值】
已生效: valid
签约中: audit
已失效: invalid
【示例值】valid
mini_category_info_list|小程序类目列表可选miniappcategoryinfo[]
【描述】新小程序类目列表
first_category_id|一级类目id必选string(16)
【描述】一级类目id
【示例值】xs1020
first_category_name|一级类目名称必选string(16)
【描述】一级类目名称
【示例值】购物
second_category_id|二级类目id必选string(16)
【描述】二级类目id
【示例值】xs2167
second_category_name|二级类目名称必选string(64)
【描述】二级类目名称
【示例值】零售门店
third_category_id|三级类目id可选string(16)
【描述】三级类目id,可空
【示例值】xs3175
third_category_name|三级类目名称可选string(64)
【描述】三级类目名称,可空
【示例值】服饰箱包门店
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
base_audit_record|准入审核驳回原因可选miniappauditreason
【描述】准入审核驳回原因
(提审时 audit_rule 传 base_promote 时有该字段)
audit_images可选string[](1024)
【描述】审核图片列表
【示例值】["xxx.png"]
memos|驳回原因列表可选miniappauditreasonmemo[]
【描述】驳回原因列表
memo|驳回原因可选string(1024)
【描述】驳回原因
【示例值】js错误检测:发现js错误,请及时优化
memo_image_list可选string[](1024)
【描述】规则图片链接
【示例值】["xxx.png"]
promote_audit_record|营销审核驳回原因可选miniappauditreason
【描述】营销审核驳回原因
(提审时 audit_rule 传 base_promote 时有该字段)
audit_images可选string[](1024)
【描述】审核图片列表
【示例值】["xxx.png"]
memos|驳回原因列表可选miniappauditreasonmemo[]
【描述】驳回原因列表
memo|驳回原因可选string(1024)
【描述】驳回原因
【示例值】js错误检测:发现js错误,请及时优化
memo_image_list可选string[](1024)
【描述】规则图片链接
【示例值】["xxx.png"]
响应示例
正常示例
异常示例
{
"alipay_open_mini_version_detail_query_response": {
"code": "10000",
"msg": "success",
"app_version": "0.0.1",
"app_name": "小程序demo",
"app_english_name": "demoexample",
"app_logo": "http://image.aaaa.alipay.com",
"version_desc": "这是一个简单的版本描述",
"gray_strategy": "p10",
"status": "init",
"reject_reason": "名称太宽泛",
"scan_result": "true",
"gmt_create": "2017-12-12 12:00:00",
"gmt_apply_audit": "2017-12-12 12:00:00",
"gmt_online": "2017-12-12 12:00:00",
"gmt_offline": "2017-12-12 12:00:00",
"app_desc": "小程序demo的相关示例",
"gmt_audit_end": "2017-12-12 12:00:00",
"service_region_type": "location",
"service_region_info": [
{
"province_code": "310000",
"province_name": "浙江省",
"city_code": "310000",
"city_name": "杭州市",
"area_code": "311100",
"area_name": "余杭区"
}
],
"screen_shot_list": [
"http://image.aaa.alipay.com"
],
"app_slogan": "小程序demo简介",
"memo": "这是一个demo示例",
"service_phone": "13110101010",
"service_email": "example@mail.com",
"mini_app_category_info_list": [
{
"first_category_id": "xs1020",
"first_category_name": "购物",
"second_category_id": "xs2167",
"second_category_name": "零售门店",
"third_category_id": "xs3175",
"third_category_name": "服饰箱包门店"
}
],
"package_info_list": [
{
"package_name": "小程序基础功能包",
"package_desc": "通用能力",
"doc_url": "http://doc.aaa.alipay.com",
"status": "valid",
"package_open_type": "apply"
}
],
"mini_category_info_list": [
{
"first_category_id": "xs1020",
"first_category_name": "购物",
"second_category_id": "xs2167",
"second_category_name": "零售门店",
"third_category_id": "xs3175",
"third_category_name": "服饰箱包门店"
}
],
"base_audit": "pass",
"promote_audit": "pass",
"can_release": "true",
"base_audit_record": {
"audit_images": [
"xxx.png"
],
"memos": [
{
"memo": "js错误检测:发现js错误,请及时优化",
"memo_image_list": [
"xxx.png"
]
}
]
},
"promote_audit_record": {
"audit_images": [
"xxx.png"
],
"memos": [
{
"memo": "js错误检测:发现js错误,请及时优化",
"memo_image_list": [
"xxx.png"
]
}
]
}
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}
说明:本示例仅供参考。
公共错误码
业务错误码
错误码 | 错误描述 | 凯发app官方网站的解决方案 |
---|---|---|
system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常,导致服务调用失败,商户可以用同样的请求发起重试 |
application_type_not_miniapp | 应用类型不是小程序类型 | 请使用小程序类型的应用 |
application_type_not_miniapp | 该应用不是小程序类型 | 该应用不是小程序类型,请检查应用类型 |
app_version_is_blank | 版本号为空 | 请输入小程序的版本号 |
bundle_id_not_exist | 端参数不存在 | 请根据示例值输入正确的端参数 |
version_is_blank | 版本字段为空 | 版本字段为空, 请传入app_version字段 |