wangquanlong / weixinpy

Python client SDK for Micro Message Public Platform API.

weixinpy

这是一个python版本的腾讯微信公共平台的API的sdk。

---

Usage

初始化过程：

from weixin import WeixinClient, APIError, AccessTokenError
# 如果你有使用python-memcache 可以使用fc=False，path='ip:port'来启用memcache。
# 如果你想问memcache能不能吃，还是老老实实用fc=True吧，path用来设置你保存临时文件的路径。
wc = WeiXinClient('您的AppID', '您的AppSecret', fc=True, path='/tmp')
# 使用其他api前必须先获取token
wc.request_access_token()

请求用户列表： API格式：https://api.weixin.qq.com/cgi-bin/user/get?access_token=ACCESS_TOKEN&next_openid=NEXT_OPENID

# 我们这里是第一次调用所以next_openid=None
rjson = wc.user.get._get(next_openid=None)
count = rjson.count
id_list = rjson.data.openid
while count < rjson.total:
    rjson = wc.user.get._get(next_openid=rjson.next_openid)
    count += rjson.count
    id_list.extend(rjson.openid)
# 最后看看都有哪些用户
print id_list

发送文字信息： API格式：https://api.weixin.qq.com/cgi-bin/message/custom/send?access_token=ACCESS_TOKEN

for uid in id_list:
    content = '{"touser":"%s", "msgtype":"text", "text":{ "content":"hello!"}}' %uid
    #print 可以看有没有发送成功, 可以捕获api错误异常
    try:
        print wc.message.custom.send.post(body=content)
    except APIError, e:
        print e, uid

上传并发送媒体： API格式：http://file.api.weixin.qq.com/cgi-bin/media/upload?access_token=ACCESS_TOKEN&type=TYPE

rjson = wc.media.upload.file(type='image', pic=open('/home/pi/ocr_pi.png', 'rb'))
print rjson
# 把上传的图片发出去
for uid in id_list:
    content = '{"touser":"%s", "msgtype":"image", ' \
        '"image":{ "media_id":"%s"}}' % (uid, rjson.media_id)
    try:
        print wc.message.custom.send.post(body=content)
    except APIError, e:
        print e, uid

下载媒体文件，如何判断token失效： API格式：http://file.api.weixin.qq.com/cgi-bin/media/get?access_token=ACCESS_TOKEN&media_id=MEDIA_ID

# 这里演示了如何捕获token失效的异常，产生这个异常就要更新token了
try:
    print wc.media.get.file(media_id=rjson.media_id, path='./test2.png')
except AccessTokenError, e:
    print e
    #更新token
    wc.refurbish_access_token()

# 另外我们可以主动判断token是否失效, 这里只是在时间上验证，大多数的情况下是能正常工作的
if wc.is_expires():
    wc.refurbish_access_token()

Have Fun!