通用场景
查询使用模板的小程序列表
公共请求参数
业务请求参数
template_id｜小程序模板appid必选string[1,32]
【描述】小程序模板appid
【示例值】1
page_num｜页码可选number[1,99999]
【描述】查询的页数，起始为 1（第一页） 。默认第一页。
【示例值】1
page_size｜分页大小可选number[1,50]
【描述】每页的数量，最多查询50个，默认查询10个
【示例值】10
template_version｜模板小程序的版本号可选string[1,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.template.usage.query&format=json&sign=${sign}&app_id=${appid}&version=1.0&sign_type=rsa2×tamp=${now}' \
-f 'biz_content={
"template_version":"0.0.1",
"bundle_id":"com.alipay.alipaywallet",
"page_num":1,
"template_id":"1",
"page_size":10
}' 说明：本示例仅供参考。
公共响应参数
业务响应参数
template_usage_info_list｜模板使用信息可选templateusageinfo[]
【描述】模板使用信息
mini_app_id｜商家小程序appid必选string(16)
【描述】商家小程序appid
【示例值】2018011111111111
app_version｜商家小程序版本号必选string(64)
【描述】商家小程序版本号
【示例值】0.0.1
响应示例
正常示例
异常示例
{
"alipay_open_mini_template_usage_query_response": {
"code": "10000",
"msg": "success",
"template_usage_info_list": [
{
"mini_app_id": "2018011111111111",
"app_version": "0.0.1"
}
]
},
"sign": "eritjkeijkjhkkkkkkkhjereeeeeeeeeee"
}说明：本示例仅供参考。
公共错误码
业务错误码
| 错误码 | 错误描述 | 凯发app官方网站的解决方案 |
|---|---|---|
| system_error | 系统繁忙 | 服务器异常 可能发生了网络或者系统异常，导致服务调用失败，商户可以用同样的请求发起重试 |
| application_type_not_isvapp | 该应用不是三方类型的应用 | 请使用三方类型的应用 |
| bundle_id_not_exist | 端参数不存在 | 请根据示例值输入正确的端参数 |
| invalid_page_num | 非法的页码 | 请输入合法的页码，是个正数 |
| invalid_page_size | 非法的页面大小 | 请输入合法的页面大小，是个正数 |
| invalid_params | 参数非法 | 确认参数后重新提交 |
| isv_app_id_is_blank | 三方应用id不存在 | 该接口需要带应用授权token来调用 |
| page_size_exceed_max_query_size | 页面大小超出最大的查询数量 | 一次性最多查询50个 |
| template_id_isvappid_not_match | 模板id和isvappid不匹配 | 检查templateid是否属于发起调用的三方应用 |
| template_id_is_blank | 模板id为空 | 请输入模板id |
| template_no_relation_error | 未找到实例化应用 | 未找到实例化应用 |