微信公众平台——分享接口踩坑记

2023-11-10 12:28:16

前言

本以为有微信公众平台开发文档，自定义分享样式还不简单？带着这样的想法，经历了两天半的踩坑经历，我写下了这篇文章。

开发分享接口在目录中：微信网页开发 --> 微信SDK说明文档中

流程摘要

一、按照文档，第一步要绑定安全域名，即“JS接口安全域名”（此处标记1号坑）

二、第二步引入JS文件，需要下载并将其上传到服务器。这里要注意，在第一步中绑定的域名（路径）要能够访问到这个文件

三、第三步通过config接口注入权限验证配置。这里面的参数全部都要从后端获取，我的方案是服务端渲染。如果验证不通过最有可能的原因是签名算法错误。此步骤后端有很多的工作要做：先获取access_token，再根据它获取jsapi_ticket，然后再写签名算法进行计算得出签名，才将这些数据渲染到前端页面上。（此处标记踩坑点）

四、第四步ready和error接口，并且将分享接口写在ready内。

正文

一、关于JS接口安全域名。

　　最理想的是绑定网站地址，例如www.baidu.com。如果暂时不知道如何办成，可以先绑一个路径，如www.baidu.com/mp。

　　为什么这里是1号坑？因为你如果绑定的是路径，你要分享的链接一定要在绑定的这个路径下，即使是同一个域名，不在这个路径下，对不起，签名非法。

　　所以如果你想让该域名下所有的链接都可以用上自定义分享样式，就要将其绑定网站地址。

二、关于config接口。主要的工作在后端：

　　1.获取access_token。（二号大坑，内含若干小坑）

　　　　微信公众平台有两种access_token，一种可以用来第三方登录，另一种就是JS-SDK使用。获取它需要你的开发者ID和密码。

　　　　此处要注意，(一)服务号和企业号是不一样的！

　　　　（1）ID和密码不一样。服务号是appID和appSecret，而企业号叫做corpid和corpsecret

　　　　（2）获取token的链接不一样，前者是api开头，后者是qyapi开头。我做的是服务号（虽然认证主体也是企业），地址是https://api.weixin.qq.com/cgi-bin/token

　　　　（二）两种access_token要区别清楚

　　　　（1）请求地址和参数不一样，前者地址是https://api.weixin.qq.com/sns/oauth2/access_token　　后者是https://api.weixin.qq.com/cgi-bin/token。此处我们用的是后者

　　　　（2）请求次数不一样。前者可以无限次获取，后者获取次数非常有限（具体次数不详），官方建议自己设缓存，且有效期7200秒。

　　　　（三）如果access_token获取不对，下一步会报错，官方有提供测试获取token

　　2.获取jsapi_ticket（三号大坑）

　　　　确保token获取正确后，我们来获取ticket。同样地，

　　　　（1）要区别服务号和企业号，因为请求地址都不一样，此处是https://api.weixin.qq.com/cgi-bin/ticket/getticket（不含参数）

　　　　（2）获取次数有限，有效期同7200S，需设缓存。

　　3.签名算法

　　　　这里不多说，官方有提供签名算法的验证检测。

三、一切都完成以后

调试没有报错，测试分享成功，本以为大功告成，可又出了一些问题？

IOS端分享正常，Android端却还是自定义之前的老样子
无论是IOS端还是Android端，点击第一次分享出来的链接，再次分享，又回到了老样子

解决：

问题出在微信平台。分享接口有很多个，我只用了updateAppMessageShareData和updateTimelineShareData，后面即将废弃的几个接口既没有声明也没有使用。这看上去没问题，可这就是问题所在（测试人员的微信都是7.0版本，JS-SDK版本是1.4.0）。解决办法是将所有分享接口都在config中声明。
二次分享问题。原因在第一次分享以后腾讯在原url上加了一些参数，导致新的url与原来的不符，与计算签名时的url不同，签名无效。解决办法是前端第一行js代码判断当前url是否是原url，如果不是则跳转到原url。

四、代码贡上

Python Django后端：

def get_accesstoken():
    "获取access_token"
    appid = ‘************‘
    appsecret = ‘***********‘

    def http_get_token(conn, now_time):
        "向服务器获取token"
        try:
            url = u‘https://api.weixin.qq.com/cgi-bin/token‘
            params = {
                ‘appid‘: appid,
                ‘secret‘: appsecret,
                ‘grant_type‘: ‘client_credential‘
            }
            res = requests.get(url, params=params).json()
            access_token = res[‘access_token‘]
            # 存redis缓存
            conn.hmset("access_token", {"token": access_token, "timestamp": now_time})
            return access_token
        except Exception as e:
            traceback.print_exc()
            return HttpResponse(json.dumps(‘access_token获取失败:%s‘ % e))

    # 首先取缓存
    conn = redis.StrictRedis(host=‘127.0.0.1‘, port=‘6379‘)
    redis_token = conn.hgetall("access_token")
    now_time = time.time()
    if redis_token:  # 如果有token缓存
        redis_time = float(str(redis_token[b"timestamp"], encoding="utf-8"))
        if now_time - redis_time < 6000:  # 如果token没过期
            access_token = str(redis_token[b"token"], encoding="utf-8")
        else:  # 如果已过期，重新获取
            access_token = http_get_token(conn, now_time)
    else:  # 如果没有缓存,创建一个
        access_token = http_get_token(conn, now_time)

    return access_token

def get_jsapiticket(access_token):
    "获取 jsapi_ticket"

    def http_get_jsapi(conn, now_time):
        try:
            url2 = u‘https://api.weixin.qq.com/cgi-bin/ticket/getticket‘
            params = {
                ‘access_token‘: access_token,
                ‘type‘: ‘jsapi‘
            }
            res2 = requests.get(url2, params=params).json()
            if res2["errmsg"] == "ok":
                jsapi_ticket = res2["ticket"]
                conn.hmset("jsapi", {"ticket": jsapi_ticket, "timestamp": now_time})
                return jsapi_ticket
        except Exception as e:
            traceback.print_exc()
            return HttpResponse(json.dumps(‘jsapi获取失败:%s‘ % e))

    # 首先取缓存
    conn = redis.StrictRedis(host=‘127.0.0.1‘, port=‘6379‘)
    redis_jsapi = conn.hgetall("jsapi")
    now_time = time.time()
    if redis_jsapi:  # 如果有token缓存
        redis_time = float(str(redis_jsapi[b"timestamp"], encoding="utf-8"))
        if now_time - redis_time < 6000:  # 如果token没过期
            jsapi_ticket = str(redis_jsapi[b"ticket"], encoding="utf-8")
        else:  # 如果已过期，重新获取
            jsapi_ticket = http_get_jsapi(conn, now_time)
    else:  # 如果没有缓存,创建一个
        jsapi_ticket = http_get_jsapi(conn, now_time)

    return jsapi_ticket

def share(url):
    "自定义分享"
    appid = ‘***********‘

    # 获取access_token
    access_token = get_accesstoken()
    # 获取jsapi_ticket
    jsapi_ticket = get_jsapiticket(access_token)

    if jsapi_ticket is not None:
        # 签名算法
        class Sign:
            def __init__(self, jsapi_ticket, url):
                self.ret = {
                    ‘nonceStr‘: self.__create_nonce_str(),
                    ‘jsapi_ticket‘: jsapi_ticket,
                    ‘timestamp‘: self.__create_timestamp(),
                    ‘url‘: url
                }

            def __create_nonce_str(self):
                return ‘‘.join(random.choice(string.ascii_letters + string.digits) for _ in range(15))

            def __create_timestamp(self):
                return int(time.time())

            def sign(self):
                string = ‘&‘.join([‘%s=%s‘ % (key.lower(), self.ret[key]) for key in sorted(self.ret)]).encode(
                    encoding="utf-8")
                self.ret[‘signature‘] = hashlib.sha1(string).hexdigest()
                return self.ret

        sign = Sign(jsapi_ticket, url)
        we_share = sign.sign()
        we_share.setdefault("appid", appid)

        return we_share
    else:
        print("jsapi为空，share没有返回值")

前端：

<script>
    // 自定义数据
    var title = "{{ news.0.N_Title }}";
    var link = window.location.href.split("?")[0];
    var imgUrl = "http://www.smcic.cn/static/static_img/share_icon.png";
    var desc = $(".post-content").text().replace(/\s+/g, "").replace(/[\r\n]/g,"").substr(0,50);
    if(link  !== window.location.href) // 二次分享处理
    {
        window.location.href = link;
    }
    
    wx.config({
        debug: false, // 开启调试模式,调用的所有api的返回值会在客户端alert出来，若要查看传入的参数，可以在pc端打开，参数信息会通过log打出，仅在pc端时才会打印。
        appId: "{{ we_share.appid }}", // 必填，公众号的唯一标识
        timestamp: parseInt("{{ we_share.timestamp }}"), // 必填，生成签名的时间戳
        nonceStr: "{{ we_share.nonceStr }}", // 必填，生成签名的随机串
        signature: "{{ we_share.signature }}", // 必填，签名
        jsApiList: [ //使用的JS接口列表,如果需要其他的功能，再添加对应api
            ‘updateAppMessageShareData‘,
            ‘updateTimelineShareData‘,
            ‘onMenuShareTimeline‘,
            ‘onMenuShareAppMessage‘,
            ‘onMenuShareQQ‘,
            ‘onMenuShareQZone‘,
            ‘onMenuShareWeibo‘,
        ]
    });
    
    wx.ready(function () {
        wx.updateAppMessageShareData({
            title: title,   // 分享标题
            link: link,     // 分享链接，该链接域名或路径必须与当前页面对应的公众号JS安全域名一致
            desc: desc,
            imgUrl: imgUrl, // 分享图标
            success: function () {
                // 用户确认分享后执行的回调函数
            },
            cancel: function () {
                // 用户取消分享后执行的回调函数
            }
        });
        wx.updateTimelineShareData({
            title: title, // 分享标题
            desc: desc, // 分享描述
            link: link, // 分享链接，该链接域名或路径必须与当前页面对应的公众号JS安全域名一致
            imgUrl: imgUrl, // 分享图标
            type: ‘‘, // 分享类型,music、video或link，不填默认为link
            dataUrl: ‘‘, // 如果type是music或video，则要提供数据链接，默认为空
            success: function () {
                // 用户确认分享后执行的回调函数
            },
            cancel: function () {
                // 用户取消分享后执行的回调函数
            }
        });
    });

    wx.error(function (res) {
        console.log("失败",res);
    });
</script>