前后端分离djangorestframework—— 接入微信模板消息推送

微信

什么是微信也不多说，跟前面的支付宝一样的

微信支付

微信支付也有个沙箱环境，沙箱环境官方文档  

由文档中那句很显眼的话所得，即使是测试环境也需要真实的商户号，所以这个就没法想支付宝那样用沙箱账号来演示了。至于为什么没有沙箱账号这就不得而知了，想接入微信支付商户的朋友，请移步先注册为商户，上传相关资料审核后方可使用：传送门 

所以关于微信支付，由于这些种种限制，就不去注册商户了，所以支付方面本文在此略过，感兴趣的朋友自己去研究了，我看微信的文档也很浅显易懂的 

微信模板消息推送

因为微信的模板消息推送改版，现在需要认证的微信企业号才能玩，所以目前来说我们只能使用微信给的沙箱测试平台了，传送门 

用你的微信登录，之后会给我们自动生成一个id 和key:

还有一个测试的可用公众账号：

接着按微信官方给的文档：模板消息推送

其实大概的流程就是这样：

1.默认情况下，用户的微信只和微信服务端有联系，且微信服务端里有用户的唯一ID，而我们的平台的目标是要通过公众号给用户发消息

2.但是默认用户的微信和我们平台的微信不相通的，如隔了一道墙

3.我们给用户一个页面，页面上有我们的二维码，让用户扫码关注我们的公众号

4.在第3步操作也是通过微信的服务端作为中间人完成的，且当用户关注成功的同时，微信服务端会把用户ID自动回传（或者说回调）给我们平台的公众号

5.拿到用户ID之后，我们的微信公众号就可以给用户推送消息了

其实步骤是挺简单的，上面5步中，其实实际的业务逻辑只有第3，第4和第5三个步骤，且这几个步骤里每个的请求url都需要通过微信服务端来完成，所以还需要再看下微信的官方文档给我们解说的

前期准备：

1,修改地址：

还是刚才那个申请测试账号页面，滑动下面，找到网页账号这里，点修改

看到的提示，写得很清楚，我这里只是作为测试而已，这个地址不能是127.0.0.1换回地址了，至少得是局域网地址，因为一会儿用手机微信测试时需要调用这个地址，所以你的手机得和电脑是同一个局域网段，当然真实的使用时是公网的地址

 

 点击确认之后，显示通过安全检测的话就配置成功了

2.还要创建一个模板，获取一个模板id

点新增测试模板：添加模板时注意格式，比如下面的{{first.DATA}}，这个【.DATA】才是我们需要添加的数据，其他都不是，就好比Python中的字符串格式化一样，做类比理解就很能懂了

按照文档给的提示操作就行，提交之后如下，所以你如果填错了，只能删除重新添加，不能修改

3.作为接收信息的用户微信号必须关注测试账号：

 4.如果有需要的话，设置js的sdk url

当然是要调用微信的sdk时才会用到这个

代码实现

前面的准备工作准备好之后，开始写代码 

不过，先通过微信的文档，得知我们此时需要用的url：

1.绑定url:

https://open.weixin.qq.com/connect/oauth2/authorize?appid=APPID&redirect_uri=REDIRECT_URI&response_type=code&scope=SCOPE&state=STATE#wechat_redirect

相关参数：

参数	必须	说明
appid	是	公众号的唯一标识（这个就是我们前面申请的）
redirect_uri	是	授权后重定向的回调链接地址（我们前面申请的）
response_type	是	返回类型，请填写code
scope	是	应用授权作用域，snsapi_base （不弹出授权页面，直接跳转，只能获取用户openid），snsapi_userinfo （弹出授权页面，可通过openid拿到昵称、性别、所在地。并且，即使在未关注的情况下，只要用户授权，也能获取其信息）
state	否	重定向后会带上state参数，开发者可以填写a-zA-Z0-9的参数值，最多128字节，该值会被微信原样返回，我们可以将其进行比对，防止别人的攻击。
#wechat_redirect	否	直接在微信打开链接，可以不填此参数。做页面302重定向时候，必须带此参数

 2.获取token的url

https://api.weixin.qq.com/sns/oauth2/access_token

相关参数：

appid	您的测试id号
secret	您的测试id的secret
code	微信自动回传的参数，用request.GET.get("code")获取
grant_type	authorization_code

3.发送模板消息的接口

https://api.weixin.qq.com/cgi-bin/message/template/send?access_token=ACCESS_TOKEN


 

 

4.发送非模板，正文消息的url

https://api.weixin.qq.com/cgi-bin/message/custom/send

相关参数跟模板消息的参数一样

真正的代码实现

好的，开始码代码，干！

创建一个名为WachatTest的django项目，app名就是app：

 然后因为要生成二维码，此处运用了qrcode.js的第三方js库   文件下载：点我

根目录创建static目录，存放如下文件，wx.jpg就是刚才那个测试微信公众号的图片，我把它下载下来并更名为wx.jpg了

url:

 

html:

settings:

 还是配置文件部分，如果你启动项目时提示ALLOW_HOSTS之类的错误，作如下更改：

views:

与模板相关的配置，注意与之前创建的模板对应

model，db_index=True的意思是自动在数据创建索引的意思

运行项目之前记得迁移数据库，并写入几个数据作为测试

启动项目，登录再关注，不多说

 登录成功之后，绑定页面，点击按钮之后，把这个测试的公众号二维码图片转成了带有一些参数的url，然后qrcode把这个带有参数的url转成了二维码：

我用一个微信号测试扫码之后（前提必须先关注那个微信公众测试号才能授权），点击允许

然后会跳转到这个界面，表示成功授权

现在再做最终的模板消息发送，访问/sendmsg:

查看手机端信息，得到的信息正好是我们之前设置的

 

大概的流程就走完了，因为我只是测试，没有做得多么高大上，其实比如那个模板消息，可以根据不同的用户发不同的数据，或者这段数据直接搞一个form表单，让非开发人员也可以使用它，点击发送就行了，还有上面说的那个当前用户的问题，只给当前用户发，不给没有操作的人发，或者定向群发啥啥的，反正主要的开发逻辑就这些，其他的随便玩，玩出花来都可以

微信官方的全部流程：传送门

相关的代码：

import hashlib
from django.db import models


class UserInfo(models.Model):
    username = models.CharField("用户名", max_length=64, unique=True)
    password = models.CharField("密码", max_length=64)
    uid = models.CharField(verbose_name='个人唯一ID', max_length=64, unique=True)
    wx_id = models.CharField(verbose_name="微信ID", max_length=128, blank=True, null=True, db_index=True)

    def save(self, *args, **kwargs):
        # 创建用户时，为用户自动生成个人唯一ID
        if not self.pk:
            m = hashlib.md5()
            m.update(self.username.encode(encoding="utf-8"))
            self.uid = m.hexdigest()
        super(UserInfo, self).save(*args, **kwargs)

from django.contrib import admin
from django.urls import path
from app import views

urlpatterns = [
    path('admin/', admin.site.urls),
    path('login/', views.login),
    path('bind/', views.bind),
    path('bind_qrcode/', views.bindQrcode),
    path('callback/', views.callback),
    path('sendmsg/', views.sendmsg)
]

from django.shortcuts import render, HttpResponse, redirect
from django.http import JsonResponse
from django.conf import settings
import requests
from app import models
import json


# Create your views here.
def login(request):
    """
    用户登录
    :param request:
    :return:
    """
    # models.UserInfo.objects.create(username='luffy',password=123)

    if request.method == "POST":
        user = request.POST.get('user')
        pwd = request.POST.get('pwd')
        obj = models.UserInfo.objects.filter(username=user, password=pwd).first()
        if obj:
            request.session['user_info'] = {'id': obj.id, 'name': obj.username, 'uid': obj.uid}
            return redirect('/bind/')
    else:
        return render(request, 'login.html')


def bind(request):
    """用户绑定页面"""
    return render(request, 'auth.html')


def bindQrcode(request):
    """生成二维码"""
    ret = {'code': 1000}
    try:
        access_url = "https://open.weixin.qq.com/connect/oauth2/authorize?appid={appid}&redirect_uri={redirect_uri}&response_type=code&scope=snsapi_userinfo&state={state}#wechat_redirect"
        access_url = access_url.format(
            appid=settings.WECHAT_CONFIG["app_id"],
            redirect_uri=settings.WECHAT_CONFIG["redirect_uri"],
            state=request.session['user_info']['uid']
        )
        ret['data'] = access_url
    except Exception as e:
        ret['code'] = 1001
        ret['msg'] = str(e)
    return JsonResponse(ret)


def callback(request):
    """
    用户在手机微信上扫码后，微信自动调用该方法。
    用于获取扫码用户的唯一ID，以后用于给他推送消息。
    :param request:
    :return:
    """
    code = request.GET.get("code")

    # 用户UID
    state = request.GET.get("state")

    # 获取该用户openId(用户唯一，用于给用户发送消息)
    res = requests.get(
        url="https://api.weixin.qq.com/sns/oauth2/access_token",
        params={
            "appid": settings.WECHAT_CONFIG["app_id"],
            "secret": settings.WECHAT_CONFIG["appsecret"],
            "code": code,
            "grant_type": 'authorization_code',
        }
    ).json()
    # 获取的到openid表示用户授权成功

    openid = res.get("openid")
    if openid:
        models.UserInfo.objects.filter(uid=state).update(wx_id=openid)
        response = "<h1>授权成功 %s </h1>" % openid
    else:
        response = "<h1>用户扫码之后，手机上的提示</h1>"
    return HttpResponse(response)


def get_access_token():
    """获取token"""
    result = requests.get(
        url='https://api.weixin.qq.com/cgi-bin/token',
        params={
            "grant_type": "client_credential",
            "appid": settings.WECHAT_CONFIG['app_id'],
            "secret": settings.WECHAT_CONFIG['appsecret'],
        }
    ).json()
    if result.get('access_token'):
        access_token = result.get('access_token')
    else:
        access_token = None
    return access_token


def send_content_msg(user_id, access_token):
    """内容消息发送"""
    body = {
        'touser': user_id,
        'msgtype': 'text',
        'text': {
            'content': '内容。。。。。不是模板消息'
        }
    }
    response = requests.post(
        url='https://api.weixin.qq.com/cgi-bin/message/custom/send',
        params={
            'access_token': access_token
        },
        data=bytes(json.dumps(body, ensure_ascii=False), encoding='utf-8')
    )
    result = response.json()
    return result


def send_template_msg(user_id, access_token):
    """模板消息发送"""
    result = requests.post(
        url='https://api.weixin.qq.com/cgi-bin/message/template/send',
        params={
            'access_token': access_token
        },
        json={
            "touser": user_id,
            "template_id": settings.WECHAT_CONFIG['template_id'],
            "data": {
                "first": {
                    "value": "微信模板页面发送消息",
                    "color": "#173177"
                },
                "kw1": {
                    "value": "卧槽调这个参数搞了有点久",
                    "color":"#173177"
                },
                "kw2": {
                    "value": "可不是咋地"
                },
                "kw3": {
                    "value": "就看这次能不能成功了"
                },
            }
        }
    )
    result = result.json()
    return result


def sendmsg(requet):
    access_token = get_access_token()
    # 这里由于我本来就只有一个数据，所以直接写死了，真实的开发当然是用当前登录用户扫码关注的用户对应
    userobj = models.UserInfo.objects.filter(id=1).first()
    # 发送模板消息
    result = send_template_msg(userobj.wx_id, access_token)

    # 发送正文消息
    # result = send_content_msg(userobj.wx_id, access_token)

    if result.get('errcode') == 0:
        return HttpResponse('发送成功')
    return HttpResponse('发送失败')

{% load staticfiles %}
<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>用户授权</title>
    <script src="{% static "js/jquery.min.js" %}"></script>
    <script src="{% static "js/jquery.qrcode.min.js" %}"></script>
    <script src="{% static "js/qrcode.js" %}"></script>
</head>
<body>
<input onclick="userauth() " type="button" value="关注我们有惊喜哦">
<div>
    <img style="height: 100px; 100px" src="{% static 'img/wx.jpg' %}">
</div>
<div id="qrcode" style=" 250px;height: 250px;background-color: white;margin: 100px auto;"></div>
<script type="text/javascript">
    function userauth() {
        $.ajax({
            url: '/bind_qrcode/',
            type: 'GET',
            success: function (data) {
                console.log(data);
                $('#qrcode').empty().qrcode({text: data.data});
            }
        });
    }
</script>
</body>
</html>

ALLOWED_HOSTS = ['192.168.0.8']


STATIC_URL = '/static/'
STATICFILES_DIRS = (
    os.path.join(BASE_DIR, 'static'),
)

# ############# 微信 ##############
WECHAT_CONFIG = {
    'app_id': '您的微信app测试id',  # 微信给的测试app id
    'appsecret': '您的微信app测试secret',  # 微信给的测试app sercret
    'redirect_uri': 'http://您的域名地址/callback/',  # 用户关注之后微信回传地址
    'template_id': "您的微信测试模板id"  # 模板id
}

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">
    <title>Title</title>
</head>
<body>
    <form action="/login/" method="post">
        {% csrf_token %}
        <input type="text" name="user" placeholder="用户名">
        <input type="password" name="pwd" placeholder="密码">
        <input type="submit" value="登录">
    </form>
</body>
</html>

总结：

感觉还是挺简单的，就是对于刚接触的朋友来说的话，可能不习惯去看第三方的API文档，也不知道怎么下手，多研究就行了，熟练了就很快了

微信支付那个，我没有企业相关材料，而且就算有，也不敢那么随意的就为了做个测试就去申请什么的，所以相关的还是看官方文档吧