Mailchimp开发者标志Mailchimp开发者文字标记

营销API快速启动

一瞥

本指南将为您提供开始使用Mailchimp营销API管理受众、控制自动化工作流、将电子邮件活动与数据库同步等所需的一切。我们将介绍如何生成您的API密钥、为您首选的语言安装客户机库,以及如何进行第一次API调用—这是对Ping端点.

创建帐户

如果你还没有Mailchimp帐户,你需要创建一个为了使用API。

生成API密钥

验证对营销API的请求的最简单方法是使用API密钥.

以下是如何为自己生成一个:

  1. 导航到API密钥组你的邮箱账号。

  2. 如果您已经列出了一个API密钥,并且希望将其用于您的应用程序,只需复制它即可。

否则,单击创建密钥并给它一个描述性名称,以提醒您它用于哪个应用程序。

笔记:记住Mailchimp API密钥提供完全的帐户访问,这一点很重要,因此您应该像使用密码一样确保其安全。由于暴露帐户API密钥存在潜在的安全风险,Mailchimp不支持使用CORS请求对营销API进行客户端调用,也不应在移动应用程序中使用API密钥。

如果您正在创建需要代表其他Mailchimp用户访问Mailchimp的集成,您需要通过Oauth 2设置身份验证相反

为您的语言安装客户端库

您可以使用通常用于发出HTTP请求的任何方法调用Marketing API,但Mailchimp提供客户端库这使得与API的交互更加简单。

要为首选语言安装客户端库,请执行以下操作:

安装客户端库

#无需安装客户端;只是用卷曲

进行第一次API调用

为了测试所有设置是否正确,我们将向Ping端点发出一个简单的请求。点击该端点可以作为Mailchimp API服务的健康检查;这不会以任何方式影响您的帐户。

要查找服务器中使用的参数mailchimp.setConfig,登录到Mailchimp帐户并查看浏览器中的URL。你会看到类似的东西https://us19.admin.www.44gig.com/; 这个美国19部分是服务器前缀。请注意,您的特定值可能不同。

进行第一次API调用

#安装jq:https://stedolan.github.io/jq/download/
                 dc=“您的\u dc”apikey=“您的API\u密钥”
                 旋度-sS\“https://${dc}.api.www.44gig.com/3.0/ping”\--用户“anystring:${apikey}”| jq-r

如果一切设置正确,并且请求发出砰的声响如果成功,响应应如下所示:

Ping端点响应

JSON
{“健康状况”:“一切都是黑猩猩!”}

下一步

现在,您已经使用您选择的API密钥和客户端库成功地向API发出了经过身份验证的请求,现在就可以深入研究Mailchimp营销API了。

你可能想做的第一件事就是学会如何创造你的第一个听众并使用API向该受众添加新联系人。您可能还想熟悉营销API文档,它概述了您将在整个API中遇到的一些常见约定,或浏览API参考文档.