Skip to content

快速开始

zwc edited this page Dec 21, 2016 · 4 revisions

微信SDK

目录

安装

使用pip

sudo pip install weixin-python

使用easy_install

sudo easy_install weixin-python

功能

  • 微信登陆
  • 微信支付
  • 微信公众号
  • 微信消息

异常

父异常类名为 WeixinError 子异常类名分别为 WeixinLoginError WeixinPayError WeixinMPError WeixinMsgError

用法

如果使用Flask

参数

  • WEIXIN_TOKEN 必填,微信主动推送消息的TOKEN
  • WEIXIN_SENDER 选填,微信发送消息的发送者
  • WEIXIN_EXPIRES_IN 选填,微信推送消息的有效时间
  • WEIXIN_MCH_ID 必填,微信商户ID,纯数字
  • WEIXIN_MCH_KEY 必填,微信商户KEY
  • WEIXIN_NOTIFY_URL 必填,微信回调地址
  • WEIXIN_MCH_KEY_FILE 可选,如果需要用退款等需要证书的api,必选
  • WEIXIN_MCH_CERT_FILE 可选
  • WEIXIN_APP_ID 必填,微信公众号appid
  • WEIXIN_APP_SECRET 必填,微信公众号appkey

上面参数的必填都是根据具体开启的功能有关, 如果你只需要微信登陆,就只要选择 WEIXIN_APP_ID WEIXIN_APP_SECRET

  • 微信消息

    • WEIXIN_TOKEN
    • WEIXIN_SENDER
    • WEIXIN_EXPIRES_IN
  • 微信登陆

    • WEIXIN_APP_ID
    • WEIXIN_APP_SECRET
  • 微信公众平台

    • WEIXIN_APP_ID
    • WEIXIN_APP_SECRET
  • 微信支付

    • WEIXIN_APP_ID
    • WEIXIN_MCH_ID
    • WEIXIN_MCH_KEY
    • WEIXIN_NOTIFY_URL
    • WEIXIN_MCH_KEY_FILE
    • WEIXIN_MCH_CERT_FILE

初始化

# -*- coding: utf-8 -*-


from datetime import datetime, timedelta
from flask import Flask, jsonify, request, url_for
from weixin import Weixin, WeixinError


app = Flask(__name__)
app.debug = True

# 初始化微信
weixin = Weixin()
weixin.init_app(app)

# 具体导入配
# 根据需求导入仅供参考
app.config.fromobject(dict(WEIXIN_APP_ID='', WEIXIN_APP_SECRET=''))

微信消息

msg = weixin.msg

app.add_url_rule("/", view_func=msg.view_func)


@msg.all
def all(**kwargs):
	"""
	监听所有没有更特殊的事件
	"""
    return msg.reply(kwargs['sender'], sender=kwargs['receiver'], content='all')


@msg.text()
def hello(**kwargs):
	"""
	监听所有文本消息
	"""
    return "hello too"


@msg.text("help")
def world(**kwargs):
	"""
	监听help消息
	"""
    return dict(content="hello world!")


@msg.subscribe
def subscribe(**kwargs):
	"""
	监听订阅消息
	"""
    print kwargs
    return "欢迎订阅我们的公众号"

微信登陆

@app.route("/login")
def login():
    """登陆跳转地址"""
	openid = request.cookies.get("openid")
    next = request.args.get("next") or request.referrer or "/",
    if openid:
        return redirect(next)

    callback = url_for("authorized", next=next, _external=True)
    url = weixin.login.authorize(callback, "snsapi_base")
    return redirect(url)


@app.route("/authorized")
def authorized():
	"""登陆回调函数"""
    code = request.args.get("code")
    if not code:
        return "ERR_INVALID_CODE", 400
    next = request.args.get("next", "/")
    data = weixin.loogin.access_token(code)
    openid = data.openid
    resp = redirect(next)
    expires = datetime.now() + timedelta(days=1)
    resp.set_cookie("openid", openid, expires=expires)
    return resp
```

# 微信支付

注意: 微信网页支付的timestamp参数必须为字符串

```

wx_pay = weixin.pay


@app.route("/pay/jsapi")
def pay_jsapi():
	"""微信网页支付请求发起"""
	try:
        out_trade_no = wx_pay.nonce_str
        raw = wx_pay.jsapi(openid="openid", body=u"测试", out_trade_no=out_trade_no, total_fee=1)
        return jsonify(raw)
    except WeixinError, e:
        print e.message
        return e.message, 400


@app.route("/pay/notify")
def pay_notify():
    """
    微信异步通知
    """
    data = wx_pay.to_dict(request.data)
    if not wx_pay.check(data):
        return wx_pay.reply("签名验证失败", False)
    # 处理业务逻辑
    return wx_pay.reply("OK", True)


if __name__ == '__main__':
    app.run(host="0.0.0.0", port=9900)
```

### 微信公众号

**注意**: 如果使用分布式,需要自己实现access_token

获取公众号唯一凭证

	weixin.mp.access_token

创建临时qrcode

	data = weixin.mp.qrcode_create(123, 30)
	print weixin.mp.qrcode_show(data.ticket)

创建永久性qrcode

	# scene_id类型
	weixin.mp.qrcode_create_limit(123)
	# scene_str类型
	weixin.mp.qrcode_create_limit("456")

长链接变短链接

	weixin.mp.shorturl("http://example.com/test")
Clone this wiki locally