WechatPy：一个功能丰富的微信公众平台第三方开源 Python SDK，可与企业微信接口

微信作为国内最大的社交平台之一，其公众平台的应用也在不断发展。面对公众号的复杂功能需求，微信开发者需要一个强大的工具来帮助他们简化开发流程。而 WechatPy 正是这样一个利器。本文将详细介绍 WechatPy 的功能特性、安装方式以及一些常见的使用场景，帮助你快速上手这一强大的 Python SDK。

功能特性

WechatPy 是一个功能丰富的微信公众平台第三方 Python SDK，主要包含以下功能：

• 普通公众平台 API：支持被动响应和主动调用的 API，使开发者能够轻松处理用户消息。
• 企业微信 API：提供企业微信接口，适合企业内部沟通和管理。
• 微信支付 API：简化了与微信支付相关的操作，帮助商家轻松实现支付功能。
• 第三方平台代公众号调用接口：有效支持第三方开发者对公众号接口的调用，方便快捷。
• 小程序云开发 API：帮助开发者管理小程序的云端计算和存储。

安装

使用 WechatPy 相对简单，推荐采用 pip 进行安装，只需在终端运行以下命令：

pip install wechatpy

如果需要升级到最新版本，可以使用下面的命令：

pip install -U wechatpy

验证请求有效性

接收到来自微信服务器的请求时，需要验证请求的有效性。具体步骤如下：

from wechatpy.utils import check_signature
from wechatpy.exceptions import InvalidSignatureException

try:
    check_signature(token, signature, timestamp, nonce)
except InvalidSignatureException:
    # 处理异常情况或忽略

验证成功后，需原样返回 echostr 参数值，以确认接入成功。

解析 XML 消息

雀巢 ESF为(wx.request)时，用户接收到的消息会以 XML 格式传输。WechatPy 提供了方便的消息解析功能：

• 对于明文模式：

from wechatpy import parse_message

msg = parse_message(xml)

• 对于加密模式，需要先解密：

from wechatpy.crypto import WeChatCrypto
from wechatpy.exceptions import InvalidSignatureException, InvalidAppIdException

crypto = WeChatCrypto(token, encoding_aes_key, appid)
decrypted_xml = crypto.decrypt_message(xml, msg_signature, timestamp, nonce)
msg = parse_message(decrypted_xml)

回复消息

当用户发送消息给公众号时，可以通过以下方式进行回复：

• 回复文本消息：

from wechatpy.replies import TextReply

reply = TextReply(content='text reply', message=msg)
xml = reply.render()

• 回复图片消息：

from wechatpy.replies import ImageReply

reply = ImageReply(message=msg)
reply.media_id = 'image media id'
xml = reply.render()

• 回复图文消息：

from wechatpy.replies import ArticlesReply

reply = ArticlesReply(message=msg, articles=[{
    'title': u'标题1',
    'description': u'描述1',
    'url': u'http://www.qq.com',
}])
xml = reply.render()

加密模式回复处理

在加密模式下，回复的 XML 需要进行加密处理才能发送回微信服务器：

if is_encrypted:  # 检查是否为加密模式
    encrypted_xml = crypto.encrypt_message(xml, nonce, timestamp)

总结

WechatPy 用其丰富的功能和简便的 install 方式，成为了解决微信开发挑战的重要工具。它不仅能够帮助开发者高效地与微信服务器进行交互，还提供了灵活的模块，使得各种功能的实现变得轻松无比。对于任何希望在微信公众号、小程序或企业微信方面深耕的开发者，WechatPy 都是一个不可或缺的开发工具。

项目地址：https://github.com/wechatpy/wechatpy