小程序二维码
产品介绍
概述
为了方便开发者更便捷地推广小程序,提供生成【小程序二维码】的能力,开发者可以将生成后【小程序二维码】在线下进行贴码推广。
产品特色
每个小程序都有一个默认【小程序二维码】,目标地址是小程序首页,另外在“小程序详情/码管理/小程序码”中还支持创建20个跳转到任意页面的【小程序二维码】。如商户需要创建超过20个小程序二维码,可以通过调用二维码接口实现。一个小程序可以使用API获取无限个带参数的二维码。
准入条件
小程序开发者均可使用。
计费模式
不收费。
页面地址获取方式
小程序页面地址可通过开发者工具在代码中的“app.json”中获取。
使用说明
支付宝扫描二维码将按以下匹配规则控制跳转:
- 页面地址:指定小程序中能访问的路径地址,默认为小程序的首页地址。
- 启动参数:小程序启动时候需要带入的参数,可以为空。启动参数可以通过 options.query 获取,格式为 key1=value1&key2=value2。
示例代码
准备获取启动参数中x的值。
App({
onLaunch(options) {
my.alert({content: '启动参数:'+JSON.stringify(options.query.x),});
console.log('query', options.query);
console.log('App Launch', options);
},
onShow() {
console.log('App Show')
},
onHide() {
console.log('App Hide')
},
globalData: {
hasLogin: false
}
})
输入参数
页面地址:“page/component/component-pages/view/view”;启动参数:x=1&y=2。
- 示例效果
接入介绍
添加“小程序二维码”功能
在小程序详情页的功能列表中添加“小程序二维码”。
调用 OpenAPI 获取二维码
在服务端接口调用 OpenAPI ,生成小程序推广二维码图片链接,以下是 Java 示例代码。
AlipayClient alipayClient = new DefaultAlipayClient("https://openapi.alipay.com/gateway.do","app_id","your private_key","json","GBK","alipay_public_key","RSA2");
AlipayOpenAppQrcodeCreateRequest request = new AlipayOpenAppQrcodeCreateRequest();
request.setBizContent("{" +
"\"url_param\":\"/index.html?name=ali&loc=hz\"," + "\"query_param\":\"name=1&age=2\"," + "\"describe\":\"二维码描述\"" +
" }");
AlipayOpenAppQrcodeCreateResponse response = alipayClient.execute(request);
if(response.isSuccess()){
System.out.println("调用成功");
} else {
System.out.println("调用失败");
}
API列表
接口名称 | 描述 |
---|---|
alipay.open.app.qrcode.create | 小程序生成推广二维码接口 |
补充说明
对于“小程序二维码生成接口”调用方式,推荐使用开放平台提供的 服务端SDK 。