weixin-python 0.2.5

微信SDK
======

提供微信登陆，公众号管理，微信支付，微信消息等处理

### 目录

* [安装](#安装)
* [微信消息](#微信消息)
* [接收消息](#接收消息)
* [回复消息](#回复消息)
* [微信登陆](#微信登陆)
* [公众号相关](#公众号管理)
* [TODO](#todo)
* [微信支付](#微信支付)


## 安装

pip install weixin-python


## 微信消息

首先初始化

from flask import Flask
from weixin.msg import WeixinMsg

app = Flask(__name__)
msg = WeixinMsg("e10adc3949ba59abbe56e057f20f883e", None, 0)

如果使用flask建议使用默认视图函数

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("*") # @msg.text()
def all_text(**kwargs):
return "hello world!"

如果需要接收文本消息的指定内容，可以使用

@msg.text("help")
def text_help(**kwargs):
return dict(content="help", type="text")

如果要接收用户的图像消息

@msg.image
def image(**kwargs):
print kwargs
return ""

有以下消息类型包装器

* 所有类型 `@msg.all`
* 文本类型 `@msg.text()` `@msg.text("help")`
* 图片类型 `@msg.image`
* 视频类型 `@msg.video` `@msg.shortvideo`
* 音频类型 `@msg.voice`
* 坐标类型 `@msg.location`
* 链接类型 `@msg.link`
* 事件类型 `@msg.event`

还可以监听具体的事件

* 订阅事件 `@msg.subscribe`
* 取消订阅事件 `@msg.unsubscribe`
* 点击事件 `@msg.click`
* 其它事件 `@msg.{event}`

### 回复消息

首先可以直接调用`msg.reply函数`

return msg.reply(
kwargs['sender'], sender=kwargs['receiver'], content='all'
)

直接返回字典，作为reply的参数

return dict(content='all')

直接返回字符串

return "hello world!"


具体使用方式可以参考 [example/msg.py](https://github.com/zwczou/weixin-python/blob/master/example/msg.py)

## 微信登陆

初始化

from weixin.login import WeixinLogin

login = WeixinLogin(app_id, app_secret)

微信有两种scope

1. snsapi_base 只能获取用户的openid，不需要用户确认
2. snsapi_userinfo 可以获取用户信息，需要用户主动确认


snsapi_base方式

url = login.authorize("http://example.com/authorized", "snsapi_base")

snsapi_usrinfo方式

url = login.authorize("http://example.com/authorized", "snsapi_userinfo")

获取用户信息

# 首根据code获取access_token跟openid
data = login.access_token(code)
# 如果scope为`snsapi_userinfo`可以执行以下操作
user_info = login.user_info(data.access_token, data.openid)
print user_info.nickname
print usre_info.name

更多用法可以参考 [example/login.py](https://github.com/zwczou/weixin-python/blob/master/example/login.py)

## 公众号管理

初始化

from weixin.mp import WeixinMP

mp = WeixinMP(app_id, app_secret)

获取公众号唯一凭证

print mp.access_token

创建临时qrcode

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

创建永久性qrcode

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

长链接变短链接

mp.shorturl("http://example.com/test")

菜单管理

# 获取菜单
try:
print mp.menu_get()
except WeixinError:
pass

# 创建菜单
data = [
{
"type": "view",
"name": "测试",
"url": "http://code.show/",
},
]
print mp.menu_create(data)

# 删除菜单
print mp.menu_delete()

更多用法参考 [example/mp.py](https://github.com/zwczou/weixin-python/blob/master/example/mp.py)

### TODO

* [X] 自定义菜单
* [X] 用户管理
* [X] 用户分组管理
* [X] 设置用户备注名
* [X] 获取用户基本信息
* [X] 获取用户列表
* [X] 获取用户地理位置
* [X] 账号管理
* [X] 生成带参数的二维码
* [X] 长链接转短链接
* [X] 微信认证事件推送
* [X] 消息管理
* [X] 普通消息 [微信消息](#微信消息)
* [ ] 模板消息
* [ ] 素材管理
* [ ] 数据统计
* [ ] 微信小店
* [ ] 微信卡卷
* [ ] 微信门店
* [ ] 微信智能


## 微信支付

初始化

from weixin.pay import WeixinPay

pay = WeixinPay(app_id, mch_id, mch_key, notify_url)

创建统一订单

out_trade_no = pay.nonce_str
try:
# 如果使用flask，默认会使用request.remoted_addr
# 如果不用flask，可以主动传入参数spbill_create_ip='8.8.8.8'
# raw = pay.unified_order(openid="openid", trade_type="JSAPI", body=u"测试", out_trade_no=out_trade_no, total_fee=1, spbill_create_ip='8.8.8.8')
raw = pay.unified_order(openid="openid", trade_type="JSAPI", body=u"测试", out_trade_no=out_trade_no, total_fee=1)
print raw["prepay_id"]
except WeixinPayError, e:
print e.message

也可以用JSAPI快速创建统一订单,并且快速返回js调起支付所需要的参数
参数包括 `package`, `appId`, `timeStamp`, `nonceStr`, `sign`

# total_fee 单位为分
pay.jsapi(openid='openid', body='测试', out_trade_no=out_trade_no, total_fee=1)

查询订单

pay.order_query(out_trade_no=out_trade_no)

关闭订单

pay.close_order(out_trade_no)

检查签名是否通过，可以在微信回调时候校验签名

if pay.check(pay.to_dict(request.data)):
print "OK"