Mailchimp

简介

Mailchimp API 管理邮件营销——受众、活动、模板、报表和自动化。认证是绑定数据中心的 API 密钥（无效密钥返回 401，已实测）。免费层覆盖轻量通讯和受众管理。

快速开始

你的 API 密钥编码了数据中心（us1…us21）——用在主机名里：

curl "https://us1.api.mailchimp.com/3.0/ping" \
  -u "anystring:YOUR_API_KEY"

{ "health_status": "Everything's Chimpy!" }

受众列表：

curl "https://us1.api.mailchimp.com/3.0/lists?count=5" \
  -u "anystring:YOUR_API_KEY"

向受众添加成员：

curl -X POST "https://us1.api.mailchimp.com/3.0/lists/LIST_ID/members" \
  -u "anystring:YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email_address": "user@example.com", "status": "subscribed"}'

认证方式

• 在 mailchimp.com 创建 API 密钥 → Account → Extras → API keys。
• 密钥含数据中心前缀（YOUR_API_KEY-us1 中的 us1）——放在主机名里（us1.api.mailchimp.com）。
• 用 HTTP basic auth 认证——用户名任意，密码是密钥（无效密钥 → 401，已实测）。

速率限制与注意事项

• 免费层：500 联系人 + 1,000 封邮件/月；API 限流约 10 次请求/秒。
• API 在 /3.0/——资源：lists（受众）、campaigns、reports、templates、automations。
• 通过 count（最大 1000）和 offset 分页。
• ping 端点是很方便的连通性检查。

常见问题

Mailchimp 免费吗？ 免费层：500 联系人和 1,000 封邮件/月。

如何获取密钥？ Account → Extras → API keys——密钥含数据中心前缀。

认证怎么工作？ 对你的数据中心主机用 HTTP basic auth（用户名忽略、密钥作密码）。