Flask-Weixin 0.5.0

Weixin for Flask.

Flask-Weixin is the implementation for http://mp.weixin.qq.com/ with the flavor of Flask. It can be used without Flask too.

Installation

You can install Flask-Weixin with pip:

$ pip install Flask-Weixin

Or, with setuptools easy_install in case you didn’t have pip:

$ easy_install Flask-Weixin

Getting Started

Eager to get started? It is always the Flask way to create a new instance:

from flask_weixin import Weixin

weixin = Weixin(app)

Or pass the app later:

weixin = Weixin()
weixin.init_app(app)

However, you need to configure before using it, here is the configuration list:

• WEIXIN_TOKEN: this is required

• WEIXIN_SENDER: a default sender, optional

• WEIXIN_EXPIRES_IN: not expires by default

For Flask user, it is suggested that you use the default view function:

app.add_url_rule('/', view_func=weixin.view_func)

@weixin.register('*')
def reply(**kwargs):
    username = kwargs.get('sender')
    sender = kwargs.get('receiver')
    content = kwargs.get('content')
    return weixin.reply(
        username, sender=sender, content=content
    )

The example above will reply anything the user sent.

Message Types

Every message from weixin has these information:

• id: message ID

• receiver: which is ToUserName in the official documentation

• sender: which is FromUserName in the official documentation

• type: message type

• timestamp: message timestamp

Text Type

Text type has an extra data: content.

Image Type

Image type has an extra data: picurl.

Link Type

Link type has extra data:

• title: article title

• description: article description

• url: original url of the article

Location Type

Location type has extra data:

• location_x

• location_y

• scale

• label

Event Type

Event type has extra data:

• event

• event_key

• latitude

• longitude

• precision

Voice Type

Event type has extra data:

• media_id

• format

• recognition