微信开发之推广支持

标签: 微信 微信二维码 微信永久二维码 微信临时二维码
1681人阅读 评论(0) 收藏 举报
分类:

微信极速开发系列文章:首发地址

前几篇文章详细介绍了微信App支付、公众号支付、微信红包、微信刷卡以及支付宝支付,今天来聊聊 推广支持之生成带参数的二维码长链接转短链接

目录
1、查看权限
2、生成带参数的二维码简介
3、接口说明
4、具体实现
5、测试
6、长链接转短链接

1、查看权限

登录微信公众平台 >开发>接口权限进行查看如下图

查看权限

2、生成带参数的二维码简介

为了满足用户渠道推广分析和用户帐号绑定等场景的需要,公众平台提供了生成带参数二维码的接口。使用该接口可以获得多个带不同场景值的二维码,用户扫描后,公众号可以接收到事件推送。

生成带参数的二维码官方介绍文档

目前有2种类型的二维码:

1、临时二维码,是有过期时间的,最长可以设置为在二维码生成后的30天(即2592000秒)后过期,但能够生成较多数量。临时二维码主要用于帐号绑定等不要求二维码永久保存的业务场景

2、永久二维码,是无过期时间的,但数量较少(目前为最多10万个)。永久二维码主要用于适用于帐号绑定、用户来源统计等场景。

当用户扫描带场景值二维码时,可能推送以下两种事件:

如果用户 还未关注公众号,则用户可以关注公众号,关注后微信会将带场景值关注事件推送给开发者。

如果用户 已经关注公众号,在用户扫描后会自动进入会话,微信也会将带场景值扫描事件推送给开发者。

3、接口说明

获取带参数的二维码的过程包括两步,首先创建二维码ticket,然后凭借ticket到指定URL换取二维码。

创建二维码ticket
每次创建二维码ticket需要提供一个开发者自行设定的参数(scene_id),分别介绍临时二维码和永久二维码的创建二维码ticket过程。

临时二维码请求说明

http请求方式: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
POST数据格式:json
POST数据例子:
{
  "expire_seconds": 604800,
  "action_name": "QR_SCENE",
  "action_info": {
    "scene": {
      "scene_id": 123
    }
  }
}

永久二维码请求说明

http请求方式: POST
URL: https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=TOKEN
POST数据格式:json
POST数据例子:
{
  "action_name": "QR_LIMIT_SCENE",
  "action_info": {
    "scene": {
      "scene_id": 123
    }
  }
}

或者也可以使用以下POST数据创建字符串形式的二维码参数:

{
  "action_name": "QR_LIMIT_STR_SCENE",
  "action_info": {
    "scene": {
      "scene_str": "123"
    }
  }
}

参数说明

参数 说明
expire_seconds 该二维码有效时间,以秒为单位。 最大不超过2592000(即30天),此字段如果不填,则默认有效期为30秒。
action_name 二维码类型,QR_SCENE为临时,QR_LIMIT_SCENE为永久,QR_LIMIT_STR_SCENE为永久的字符串参数值
action_info 二维码详细信息
scene_id 场景值ID,临时二维码时为32位非0整型,永久二维码时最大值为100000(目前参数只支持1–100000)
scene_str 场景值ID(字符串形式的ID),字符串类型,长度限制为1到64,仅永久二维码支持此字段

返回说明

正确的Json返回结果:

{
  "expire_seconds": 60,
  "ticket": "gQH47joAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL2taZ2Z3TVRtNzJXV1Brb3ZhYmJJAAIEZ23sUwMEmm3sUw==",
  "url": "http://weixin.qq.com/q/kZgfwMTm72WWPkovabbI"
}
参数 说明
ticket 获取的二维码ticket,凭借此ticket可以在有效时间内换取二维码。
expire_seconds 该二维码有效时间,以秒为单位。 最大不超过2592000(即30天)。
url 二维码图片解析后的地址,开发者可根据该地址自行生成需要的二维码图片

通过ticket换取二维码
获取二维码ticket后,开发者可用ticket换取二维码图片。请注意,本接口无须登录态即可调用。

请求说明

HTTP GET请求(请使用https协议)https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=TICKET
提醒:TICKET记得进行UrlEncode

返回说明

ticket正确情况下,http 返回码是200,是一张图片,可以直接展示或者下载。

HTTP头(示例)如下:
Accept-Ranges:bytes
Cache-control:max-age=604800
Connection:keep-alive
Content-Length:28026
Content-Type:image/jpg
Date:Wed, 16 Oct 2013 06:37:10 GMT
Expires:Wed, 23 Oct 2013 14:37:10 +0800
Server:nginx/1.4.1

错误情况下(如ticket非法)返回HTTP错误码404。

# 4、具体实现


/**
 * 生成带参数的二维码 API
 */
public class QrcodeApi
{
    private static String apiUrl = "https://api.weixin.qq.com/cgi-bin/qrcode/create?access_token=";

    public static ApiResult create(String jsonStr) {
        String jsonResult = HttpUtils.post(apiUrl + AccessTokenApi.getAccessTokenStr(), jsonStr);
        return new ApiResult(jsonResult);
    }

    /**
     * 创建临时二维码
     * @param expireSeconds 该二维码有效时间,以秒为单位。 最大不超过604800(即7天)。
     * @param sceneId 场景值ID,临时二维码时为32位非0整型
     * @return ApiResult 二维码信息
     */
    public static ApiResult createTemporary(int expireSeconds, int sceneId) {
        Map<String, Object> params = new HashMap<String, Object>();
        params.put("expire_seconds", expireSeconds);
        params.put("action_name", "QR_SCENE");

        Map<String, Object> actionInfo = new HashMap<String, Object>();
        Map<String, Object> scene = new HashMap<String, Object>();
        scene.put("scene_id", sceneId);

        actionInfo.put("scene", scene);
        params.put("action_info", actionInfo);
        return create(JsonUtils.toJson(params));
    }

    /**
     * 创建永久二维码
     * @param sceneId 场景值ID,永久二维码时最大值为100000(目前参数只支持1--100000)
     * @return ApiResult 二维码信息
     */
    public static ApiResult createPermanent(int sceneId) {
        Map<String, Object> params = new HashMap<String, Object>();
        params.put("action_name", "QR_LIMIT_SCENE");

        Map<String, Object> actionInfo = new HashMap<String, Object>();
        Map<String, Object> scene = new HashMap<String, Object>();
        scene.put("scene_id", sceneId);

        actionInfo.put("scene", scene);
        params.put("action_info", actionInfo);
        return create(JsonUtils.toJson(params));
    }

    /**
     * 创建永久二维码
     * @param sceneStr 场景值ID(字符串形式的ID),字符串类型,长度限制为1到64,仅永久二维码支持此字段
     * @return ApiResult 二维码信息
     */
    public static ApiResult createPermanent(String sceneStr) {
        Map<String, Object> params = new HashMap<String, Object>();
        params.put("action_name", "QR_LIMIT_STR_SCENE");

        Map<String, Object> actionInfo = new HashMap<String, Object>();
        Map<String, Object> scene = new HashMap<String, Object>();
        scene.put("scene_str", sceneStr);

        actionInfo.put("scene", scene);
        params.put("action_info", actionInfo);
        return create(JsonUtils.toJson(params));
    }

    private static String showQrcodeUrl = "https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=";

    /**
     * 通过ticket换取二维码地址
     * @param ticket 换取二维码参数
     * @return String url
     */
    public static String getShowQrcodeUrl(String ticket) {
        return showQrcodeUrl + ticket;
    }
}

封装接口说明:
1、QrcodeApi. create(String jsonStr) 自定义json参数生成二维码
2、QrcodeApi. createTemporary(int expireSeconds, int sceneId) 创建临时二维码,可自定义时间以及场景ID
3、QrcodeApi. createPermanent(int sceneId) 创建永久二维码,可自定义场景ID
4、QrcodeApi. createPermanent(String sceneStr) 创建永久二维码,可自定义场景值ID(字符串形式的ID)

5、测试

使用测试号进行测试,如果没有测试号可以【在此】申请

临时二维码

 public void getQrcode()
    {
        String str = "{\"expire_seconds\": 604800, \"action_name\": \"QR_SCENE\", \"action_info\": {\"scene\": {\"scene_id\": 123}}}";
        ApiResult apiResult = QrcodeApi.create(str);
        renderText(apiResult.getJson());
    }

如果没有权限则返回

{"errcode":48001,"errmsg":"api unauthorized hint: [Rkwbna0770rsz7!]"}

正确返回

{
  "expire_seconds": 604800,
  "ticket": "gQEd8DwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyYXdOV2xWLTI5aVUxdWhWRXhvMWwAAgQRv19YAwSAOgkA",
  "url": "http://weixin.qq.com/q/02awNWlV-29iU1uhVExo1l"
}

使用第三方工具根据以上Urlhttp://weixin.qq.com/q/02awNWlV-29iU1uhVExo1l生成二维码

使用第三方工具根据Url生成二维码

使用微信扫码如果未关注将会跳转是关注页,点击关注则推送subscribe事件

<xml>
<ToUserName><![CDATA[gh_8746b7fa293e]]></ToUserName>
<FromUserName><![CDATA[ofkJSuGtXgB8n23e-y0kqDjJLXxk]]></FromUserName>
<CreateTime>1482670578</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[subscribe]]></Event>
<EventKey><![CDATA[qrscene_123]]></EventKey>
<Ticket><![CDATA[gQEd8DwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyYXdOV2xWLTI5aVUxdWhWRXhvMWwAAgQRv19YAwSAOgkA]]></Ticket>
</xml>

使用微信扫码如果已关注将会向开发者推送扫码事件SCAN 如以下


<xml>
<ToUserName><![CDATA[gh_8746b7fa293e]]></ToUserName>
<FromUserName><![CDATA[ofkJSuGtXgB8n23e-y0kqDjJLXxk]]></FromUserName>
<CreateTime>1482670378</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[SCAN]]></Event>
<EventKey><![CDATA[123]]></EventKey>
<Ticket><![CDATA[gQEd8DwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyYXdOV2xWLTI5aVUxdWhWRXhvMWwAAgQRv19YAwSAOgkA]]></Ticket>
</xml>

生成永久二维码并使用ticket换取二维码

public void getQrcode2(){
        ApiResult apiResult = QrcodeApi.createPermanent(100);
        String qrcodeUrl = QrcodeApi.getShowQrcodeUrl(apiResult.getStr("ticket"));
        renderText("create>>"+apiResult.getJson()+" qrcodeUrl:"+qrcodeUrl);
    }
{
  "ticket": "gQFo8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0cwT21FZjNtM3RXbmd3REF6Ml82AAIEzyFQVwMEAAAAAA==",
  "url": "http://weixin.qq.com/q/G0OmEf3m3tWngwDAz2_6"
}

使用使用ticket换取二维码RUL
qrcodeUrl:https://mp.weixin.qq.com/cgi-bin/showqrcode?ticket=gQFo8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0cwT21FZjNtM3RXbmd3REF6Ml82AAIEzyFQVwMEAAAAAA==

直接浏览访问即可查看二维码,当然也可以下载到本地

使用<code>ticket</code>换取到的二维码

扫码后开发者响应的内容如下

<xml>
<ToUserName><![CDATA[gh_8746b7fa293e]]></ToUserName>
<FromUserName><![CDATA[ofkJSuGtXgB8n23e-y0kqDjJLXxk]]></FromUserName>
<CreateTime>1482671133</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[SCAN]]></Event>
<EventKey><![CDATA[100]]></EventKey>
<Ticket><![CDATA[gQFo8DoAAAAAAAAAASxodHRwOi8vd2VpeGluLnFxLmNvbS9xL0cwT21FZjNtM3RXbmd3REF6Ml82AAIEzyFQVwMEAAAAAA==]]></Ticket>
</xml>

如果是action_name值为QR_LIMIT_STR_SCENE为永久的字符串参数值则响应以下内容

<xml>
<ToUserName><![CDATA[gh_8746b7fa293e]]></ToUserName>
<FromUserName><![CDATA[ofkJSuGtXgB8n23e-y0kqDjJLXxk]]></FromUserName>
<CreateTime>1482671258</CreateTime>
<MsgType><![CDATA[event]]></MsgType>
<Event><![CDATA[SCAN]]></Event>
<EventKey><![CDATA[Javen测试二维码]]></EventKey>
<Ticket><![CDATA[gQGm8TwAAAAAAAAAAS5odHRwOi8vd2VpeGluLnFxLmNvbS9xLzAyMXdXUmtXLTI5aVUxMDAwMGcwN1IAAgSOxF9YAwQAAAAA]]></Ticket>
</xml>

6、长链接转短链接

将一条长链接转成短链接。
主要使用场景: 开发者用于生成二维码的原链接(商品、支付二维码等)太长导致扫码速度和成功率下降,将原长链接通过此接口转成短链接再生成二维码将大大提升扫码速度和成功率。

接口调用请求说明

http请求方式: POST
https://api.weixin.qq.com/cgi-bin/shorturl?access_token=ACCESS_TOKEN

参数说明

参数 是否必须 说明
access_token 调用接口凭证
action 此处填long2short,代表长链接转短链接
long_url 需要转换的长链接,支持http://、https://、weixin://wxpay 格式的url

接口封装

/**
 * 将一条长链接转成短链接 API
 * 文档地址:http://mp.weixin.qq.com/wiki/6/d2ec191ffdf5a596238385f75f95ecbe.html
 */
public class ShorturlApi
{
    private static String apiUrl = "https://api.weixin.qq.com/cgi-bin/shorturl?access_token=";

    public static ApiResult getShorturl(String jsonStr) {
        String jsonResult = HttpUtils.post(apiUrl + AccessTokenApi.getAccessTokenStr(), jsonStr);
        return new ApiResult(jsonResult);
    }

    /**
     * 长链接转短链接接口
     * @param longUrl 需要转换的长链接,支持http://、https://、weixin://wxpay 格式的url
     * @return ApiResult 短连接信息
     */
    public static ApiResult getShortUrl(String longUrl) {
        Map<String, Object> params = new HashMap<String, Object>();
        params.put("action", "long2short");
        params.put("long_url", longUrl);
        return getShorturl(JsonUtils.toJson(params));
    }
}

测试

将我简书主页http://www.jianshu.com/users/9be31238fda1/latest_articles 转成短链接

/**
     * 长链接转成短链接
     */
    public void getShorturl()
    {
        String str = "{\"action\":\"long2short\"," +
                "\"long_url\":\"http://www.jianshu.com/users/9be31238fda1/latest_articles\"}";
        ApiResult apiResult = ShorturlApi.getShorturl(str);
        renderText(apiResult.getJson());
    }

浏览器测试http://localhost:8080/api/getShorturl 正确返回如下内容

{"errcode":0,"errmsg":"ok","short_url":"http://w.url.cn/s/Asx90AS"}

最终将我简书主页http://www.jianshu.com/users/9be31238fda1/latest_articles
转成短链接http://w.url.cn/s/Asx90AS

推荐阅读
Android版-微信APP支付
极速开发微信公众号之微信买单
极速开发微信公众号之公众号支付
极速开发微信公众号之扫码支付
极速开发微信公众号之刷卡支付
极速开发微信公众号之现金红包
Android版-支付宝APP支付
支付宝Wap支付

记录学习的点滴,以此勉励不断奋斗的自己✌️✌️✌️ 如果对你有帮助记得点喜欢

源码下载地址

查看评论

《与熊共舞》第六章--不确定性的重负

企业文化——不管这个词是什么意思——为想要成为风险管理者的人设下了重重障碍,其中最为重要的就是对待不确定性的态度——哪怕计划最周密的工作,也可能遭遇不确定性的阻挠。一言以蔽之,这种态度就是:可以犯错,...
  • zdg
  • zdg
  • 2004-02-24 15:17:00
  • 2569

微信第三方开放平台 61007 api is unauthorized

这个是因为该小程序或者公众号绑定了多个平台 去小程序或者公众号的后台取消授权 然后重新绑定即可...
  • yao978318542
  • yao978318542
  • 2017-12-19 13:19:40
  • 4120

微信公众号Unauthorized API function

调用api的返回结果如下:       200 OK         Connection: keep-alive         Date: Wed, 15 Oct 2014 09:00:17 GM...
  • u013628152
  • u013628152
  • 2015-05-05 17:26:03
  • 21565

关于微信 openid api unauthorized 错误分析

如果在微信开发时发现有 api unauthorized, hints: [ req_id: MGYzVa0123ssz3 ] 这样的提示,大凡有做过微信开发的都会第一时间想到调用的接口是否有...
  • baronyang
  • baronyang
  • 2016-09-03 18:36:31
  • 12030

关于微信开发模式创建菜单失败 errcode:48001 errmsg:api unauthorized hint: [9U7bga0176vr44!]的解释

由于微信公众平台对2014年之后的个人订阅号(个人)不再提供微信认证,而未经认证的个人订阅号无法进行开发模式下的菜单的自定义的创建,会报错!需要有认证的公众号才能进行开发模式的自定义菜单的创建,参考见...
  • youngerlist
  • youngerlist
  • 2017-09-14 16:12:50
  • 4562

微信登录提示48001,{"errcode":48001,"errmsg":"api unauthorized, hints: [ req_id: 1QoCla0699ns81 ]"}

原因: ①:你的服务号必须是通过腾讯认证,每年是300元,如果没有认证而导致的错误提示,那就去认证,别往下看了!如果你已认证,本条原因排除,那么请继续往下看 ②:你是否是第三方网页,第三方...
  • df981011512
  • df981011512
  • 2016-11-23 14:48:02
  • 15821

微信关注公众账号的QR_LIMIT_STR_SCENE问题

为了在推广二维码中嵌入推荐会员的ID,需要使用微信公众号的场景二维码功能,索要使用生成永久二维码图片的接口。根据微信开发文档 ,目前有两种方式生成永久二维码:POST数据例子:{"action_nam...
  • baozhengw
  • baozhengw
  • 2015-03-01 14:56:01
  • 11304

微信开发之带参二维码的使用

微信如今的确是很流行,微信的开发的确有很多乐趣,作为程序员如果不懂微信开发就有些可惜,希望这次的分享能帮到程序员们。...
  • chenwill3
  • chenwill3
  • 2015-10-25 22:43:27
  • 4845

微信公众平台开发—利用OAuth2.0获取微信用户基本信息

1、首先在某微信平台下配置OAuth2.0授权回调页面: 2、通过appid构造url获取微信回传code值(appid可在微信平台下找到) 1)、微信不弹出授权页面url: A、code回...
  • angle_greensky110
  • angle_greensky110
  • 2014-06-21 16:14:56
  • 21193

调用 微信接口报错 {"errcode":48001,"errmsg":"api unauthorized, hints: [ req_id: 1QoCla0699ns81 ]"}

如下截图,仅为备份,本文转载地址: http://www.cnblogs.com/liaolongjun/p/6080240.html 以下正文↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓↓...
  • u011453631
  • u011453631
  • 2017-12-21 10:24:53
  • 738
    个人资料
    专栏达人 持之以恒
    等级:
    访问量: 21万+
    积分: 2678
    排名: 1万+
    博客专栏
    最新评论