wechat

A wechat python SDK

https://github.com/jeffkit/wechat

Last synced: 11 months ago · JSON representation

Repository

A wechat python SDK

Basic Info

Host: GitHub
Owner: jeffkit
License: gpl-3.0
Language: Python
Default Branch: master
Size: 98.6 KB

Statistics

Stars: 309
Watchers: 53
Forks: 108
Open Issues: 12
Releases: 1

Created over 13 years ago · Last pushed over 2 years ago

Metadata Files

Readme License

README.md

微信公众号Python-SDK

作者: @jeff_kit

本SDK支持微信公众号以及企业号的上行消息及OAuth接口。本文档及SDK假设使用者已经具备微信公众号开发的基础知识，及有能力通过微信公众号、企业号的文档来查找相关的接口详情。

1. 安装

pip

pip install wechat

源码安装

git clone git@github.com:jeffkit/wechat.git
cd wechat
python setup.py install

2. 用户上行消息处理框架

对于微信用户在公众号内发送的上行消息，本sdk提供了一个微型处理框架，开发者只需继承wechat.official.WxApplication类, 实现各种消息对应的方法，然后把该类与自己熟悉的web框架结合起来使用即可。

WxApplication内部会实现请求的合法性校验以及消息的分发等功能，还对上行消息对行了结构化，开发者把精力放到业务逻辑的编写即可。

WxApplication类核心方法：

WxApplication.process(params, xml, token=None, appid=None, aeskey=None)

WxApplication的process函数，接受以下参数：

params, url参数字典，需要解析自微信回调的url的querystring。格式如：{'nonce': 1232, 'signature': 'xsdfsdfsd'}
xml, 微信回调时post的xml内容。
token, 公众号的上行token，可选，允许在子类配置。
app_id, 公众号应用id，可选，允许在子类配置。
aes_key, 公众号加密secret，可选，允许在子类配置。

process最后返回一串文本(xml或echoStr)。

使用场景1：上行URL有效性验证

在微信公众号的后台设置好URL及token等相关信息后，微信会通过GET的方式访问一次该URL，开发者在URL的响应程序里直接调用app.process(params, xml=None)即可返回echStr。

qs = 'nonce=1221&signature=19selKDJF&timestamp=12312'
query = dict([q.split('=') for q in qs.split('&')])
app = YourApplication()
echo_str = app.process(query, xml=None)
# 返回echo_str给微信即可

使用场景2：处理上行消息

用户在微信公众号上发消息给公众号，微信服务器调用上行的URL，开发者需要对每次的的请求进行合法性校验及对消息进行处理，同样的，直接调用app.process方法就好。

qs = 'nonce=1221&signature=19selKDJF&timestamp=12312'
query = dict([q.split('=') for q in qs.split('&')])
body = '<xml> ..... </xml>'
app = YourApplication()
result = app.process(query, xml=body)
# 返回result给微信即可

WxApplication子类示例

下面先看看一个WxApplication的示例代码，用于把用户上行的文本返还给用户：

from wechat.official import WxApplication, WxTextResponse, WxMusic,\
    WxMusicResponse

class WxApp(WxApplication):

    SECRET_TOKEN = 'test_token'
    WECHAT_APPID = 'wx1234556'
    WECHAT_APPSECRET = 'sevcs0j'

    def on_text(self, text):
        return WxTextResponse(text.Content, text)

需要配置几个类参数，几个参数均可在公众号管理后台的开发者相关页面找到，前三个参数如果不配置，则需要在调用process方法时传入。

SECRET_TOKEN: 微信公众号回调的TOKEN
APP_ID: 微信公众号的应用ID
ENCODINGAESKEY: (可选)，加密用的SECRET，如您的公众号未采取加密传输，不需填。
UNSUPPORT_TXT:(可选)，收到某种不支持类型的消息时自动响应给用户的文本消息。
WELCOME_TXT:(可选), 新关注时默认响应的文本消息。

然后，您需要逐一实现WxApplication的各个onxxxx函数。不同类型的上行消息及事件均有对应的onxxx函数

on_xxx函数

所有的on_xxx函数列举如下：

on_text, 响应用户文本
on_link，响应用户上行的链接
on_image，响应用户上行图片
on_voice，响应用户上行语音
on_video，响应用户上行视频
on_location，响应用户上行地理位置
on_subscribe，响应用户关注事件
on_unsubscribe，响应用户取消关注事件
on_click，响应用户点击自定义菜单事件
on_scan，响应用户扫描二维码事件
onlocationupdate，响应用户地理位置变更事件
on_view，响应用户点击自定义菜单访问网页事件
onscancodepush
onscancodewaitmsg
onpicsysphoto
onpicphotooralbum
onpicweixin
onlocationselect

on_xxx函数的定义如下：

def on_xxx(self, req):
    return WxResponse()

on_xxx函数，接受一个WxRequest参数req，返回一个WxResponse的子类实例。

WxRequest

req是一个代表用户上行消息的WxRequest实例。其属性与消息的XML属性一一对应，不同的消息有几个相同的属性：

ToUserName
FromUserName
CreateTime
MsgType
MsgId

不同的消息类型对应有各自的属性，属性名与消息的xml标签名保一致。如MsgType为text的的req，有一个Content属怀，而MsgType为image的req，则有PicUrl及MediaId两个属性。更多消息详情请查看微信公众号官方文档。

WxResponse

on_xxx函数需要返回一个WxResponse的子类实例。WxResponse的子类及其构造的方式有：

WxTextResponse, 文本消息

WxTextResponse("hello", req)

WxImageResponse, 图片消息

WxImageResponse(WxImage(MediaId='xxyy'),req)

WxVoiceResponse, 语音消息

WxVoiceResponse(WxVoice(MediaId='xxyy'),req)

WxVideoResponse, 视频消息

WxVideoResponse(WxVideo(MediaId='xxyy', Title='video', Description='test'),req)

WxMusicResponse, 音乐消息

WxMusicResponse(WxMusic(Title='hey jude', 
    Description='dont make it bad', 
    PicUrl='http://heyjude.com/logo.png', 
    Url='http://heyjude.com/mucis.mp3'), req)

WxNewsResponse, 图文消息

WxNewsResponse(WxArticle(Title='test news', 
    Description='this is a test', 
    Picurl='http://smpic.com/pic.jpg', 
    Url='http://github.com/jeffkit'), req)

WxEmptyResponse, 无响应

WxEmptyResponse(req)

在Django中使用WxApplication

下面以Django为例说明，实现一个微信回调的功能(view)，利用上面示例代码中的WxApp：

from django.http import HttpResponse

def wechat(request):
    app = WxApp()
    result = app.process(request.GET, request.body)
    return HttpResponse(result)

配置 urls.py:

urlpatterns = patterns('',
    url(r'^wechat/', 'myapp.views.wechat'),
)

在Flask中使用WxApplication

from flask import request
from flask import Flask
app = Flask(__name__)

@app.route('/wechat')
def wechat():
    app = WxApp()
    return app.process(request.args, request.data)

OK.就这么多，WxApplication本身与web框架无关，不管你使用哪个Framework都可以享受到它带来的便利。

什么？你不喜欢写WxApplication的子类？！

好吧，其实，你可以在任何地方写on_xxx的响应函数。然后在使用之前，告诉一个WxApplication你要用哪个函数来响应对应的事件就好。以Django为例：

# 在任何地方写你自己的消息处理函数。
# @any_decorator   # 添加任何装饰器。
def my_text_handler(req):
    return WxTextResponse(req.Content, req)

# 在web的程序里这样使用：
def wechat_view(request):
    app = WxApplication()   # 实例化基类就好。
    app.handlers = {'text': my_text_handler}  # 设置你自己的处理器
    result = app.process(request.GET, request.body, 
        token='xxxx', app_id='xxxx', aes_key='xxxx')
    return HttpResponse(result)

嗯，可以自定义消息的handlers，而如果要针对事件自定义handlers的话，要修改app.event_handlers，数据的格式是一样的。具体的消息和事件类型的key，就直接看看源码得了。卡卡。

3. OAuth API

OAuth API目前仅支持下列常用接口：

发送消息
用户管理
自定义菜单管理
多媒体上传下载
二维码

其他接口拟于未来的版本中支持，同时欢迎大家来增补。

Owner

Name: jeff kit
Login: jeffkit
Kind: user
Location: Guangzhou
Company: gitmen.com

Website: http://www.gitmen.com
Repositories: 52
Profile: https://github.com/jeffkit

GitHub Events

Total

Watch event: 3

Last Year

Watch event: 3

Committers

Last synced: over 3 years ago

All Time

Total Commits: 66
Total Committers: 7
Avg Commits per committer: 9.429
Development Distribution Score (DDS): 0.227

Top Committers

Name	Email	Commits
jeff	j**f@f**m	51
terryso	s**i@1**m	5
lpig	o**0@y**t	4
msheng	=	3
戚志诚	z**i@c**m	1
Tod Jiang	j**g@p**m	1
tolerious	t**s@q**m	1

Committer Domains (Top 20 + Academic)

qq.com: 1 paypal.com: 1 corp.elong.com: 1 yeah.net: 1 126.com: 1 fallever.com: 1

Issues and Pull Requests

Last synced: over 2 years ago

All Time

Total issues: 14
Total pull requests: 20
Average time to close issues: 3 months
Average time to close pull requests: 8 months
Total issue authors: 13
Total pull request authors: 15
Average comments per issue: 1.0
Average comments per pull request: 0.8
Merged pull requests: 9
Bot issues: 0
Bot pull requests: 0

Past Year

Issues: 0
Pull requests: 0
Average time to close issues: N/A
Average time to close pull requests: N/A
Issue authors: 0
Pull request authors: 0
Average comments per issue: 0
Average comments per pull request: 0
Merged pull requests: 0
Bot issues: 0
Bot pull requests: 0

View more stats

Top Authors

Issue Authors

daimon99 (2)
ZoomQuiet (1)
ladyrassilon (1)
ramwin (1)
samsong8610 (1)
sumw3 (1)
LeoQuote (1)
terryso (1)
yakiang (1)
edwardwbli (1)
daoiqi (1)
bytetalking (1)
gaomd (1)

Pull Request Authors

terryso (4)
Youngson (2)
Yemsheng (2)
MovelikeOrion (1)
Susheng (1)
lpig (1)
tclh123 (1)
todjiang (1)
tolerious (1)
LeoQuote (1)
raptorz (1)
wolfyu1991 (1)
joecheng511 (1)
icedwater (1)
zhang-zx (1)

Top Labels

Issue Labels

Pull Request Labels

Packages

Total packages: 1
Total downloads:
- pypi 162 last-month

Total dependent packages: 1
Total dependent repositories: 11
Total versions: 29
Total maintainers: 1

pypi.org: wechat

Wechat Python SDK

Homepage: https://github.com/jeffkit/wechat
Documentation: https://wechat.readthedocs.io/
License: UNKNOWN
Latest release: 0.4.16
published over 10 years ago

Versions: 29
Dependent Packages: 1
Dependent Repositories: 11
Downloads: 162 Last month

Rankings

Stargazers count: 3.6%

Dependent repos count: 4.4%

Forks count: 4.4%

Average: 6.9%

Dependent packages count: 10.0%

Downloads: 11.9%

Maintainers (1)

jeff.kit

Last synced: 11 months ago

wechat

Science Score: 13.0%

Repository

Basic Info

Statistics

Metadata Files

README.md

微信公众号Python-SDK

1. 安装

pip

源码安装

2. 用户上行消息处理框架

WxApplication.process(params, xml, token=None, appid=None, aeskey=None)

使用场景1：上行URL有效性验证

使用场景2：处理上行消息

WxApplication子类示例

on_xxx函数

WxRequest

WxResponse

WxTextResponse, 文本消息

WxImageResponse, 图片消息

WxVoiceResponse, 语音消息

WxVideoResponse, 视频消息

WxMusicResponse, 音乐消息

WxNewsResponse, 图文消息

WxEmptyResponse, 无响应

在Django中使用WxApplication

在Flask中使用WxApplication

什么？你不喜欢写WxApplication的子类？！

3. OAuth API

Owner

GitHub Events

Total

Last Year

Committers

All Time

Top Committers

Committer Domains (Top 20 + Academic)

Issues and Pull Requests

All Time

Past Year

Top Authors

Issue Authors

Pull Request Authors

Top Labels

Issue Labels

Pull Request Labels

Packages

pypi.org: wechat

Rankings

Maintainers (1)

Dependencies