postmonkey 1.0b

PostMonkey 1.0b

PostMonkey 是 Mailchimp API 1.3 版本的简单 Python (2.6+) 封装。

特性

1. 100% 测试覆盖率

2. 通过出色的 Requests 库处理连接

3. 可配置的超时时间

4. 简单的 异常

基本用法

创建一个带有 Mailchimp API 密钥的 PostMonkey 实例后，您可以直接使用它调用 Mailchimp 的 API 方法。

from postmonkey import PostMonkey
pm = PostMonkey('your_api_key')
pm.ping() # returns u"Everything's Chimpy!"

如果 Mailchimp 方法调用接受参数，您可以通过关键字参数的形式提供它们。有关常见用例的示例，请参阅 示例，并参考 Mailchimp API v1.3 官方文档 以获取方法调用、参数和响应对象的完整列表。

Mailchimp 为 API 使用建立了指南/限制，请参阅他们的 常见问题解答 以获取信息。

注意：提供有效的方法名和任何所需的参数是调用者的责任。如果 Mailchimp 收到无效的请求，PostMonkey 将引发一个包含错误代码和消息的 postmonkey.exceptions.MailChimpException。有关详细信息，请参阅 Mailchimp API v1.3 - 异常。

示例

创建一个请求超时为10秒的 PostMonkey 实例

from postmonkey import PostMonkey
pm = PostMonkey('your_api_key', timeout=10)

获取您的活动列表的ID

lists = pm.lists()

# print the ID and name of each list
for list in lists['data']:
    print list['id'], list['name']

将“emailaddress”订阅到列表ID 5

pm.listSubscribe(id=5, email_address="emailaddress")

捕获 Mailchimp 返回的异常（无效的列表ID）

from postmonkey import MailChimpException
try:
    pm.listSubscribe(id=42, email_address="emailaddress")
except MailChimpException, e:
    print e.code  # 200
    print e.error # u'Invalid MailChimp List ID: 42'

获取所有“已发送”活动的活动数据

campaigns = pm.campaigns(filters=[{'status': 'sent'}])

# print the name and count of emails sent for each campaign
for c in campaigns['data']:
    print c['title'], c['emails_sent']