REST API
Marketo会公开一个REST API,该API允许远程执行系统的多项功能。 从创建程序到批量引导导入,有许多选项允许对Marketo实例进行细粒度控制。
这些API通常分为两大类:潜在客户数据库和资产。 Lead Database API允许检索Marketo人员记录和相关对象类型(如商机和公司)并与之交互。 资产API允许与营销宣传材料和工作流相关记录进行交互。
- 每日配额: 订阅每天分配的API调用数为50,000(CST凌晨12:00重置)。 您可以通过客户经理增加每日配额。
- 速率限制: 每个实例的API访问限制为每20秒100次调用。
- 并发限制: 最多十次并发API调用。
标准调用的大小限制为8KB的URI长度,正文大小为1MB,尽管我们的批量API的正文可以为10MB。 如果您的调用中有错误,则API通常仍会返回状态代码200,但JSON响应将包含一个值为false
的“success”成员,以及“errors”成员中的错误数组。 此处提供有关错误的更多信息。
开始使用
以下步骤需要在Marketo实例中具有管理员权限。
对于您首次调用Marketo,您将检索一条潜在客户记录。 要开始使用Marketo,您必须获取API凭据才能对实例进行经过身份验证的调用。 登录到您的实例并转到 Admin -> Users and Roles。
单击 Roles 选项卡,然后单击“新建角色”,并至少为Access API组中的角色分配“只读潜在客户”(或“只读人员”)权限。 请确保为其提供一个描述性名称,然后单击 Create。
现在,返回Users选项卡并单击 Invite New User。 为您的用户提供一个描述性名称(指示它是API用户)和一个电子邮件地址,然后单击 Next。
然后,选中API Only选项并授予用户您创建的API角色,然后单击 Next。
要完成用户创建过程,请单击 Send。
接下来,转到Admin菜单并单击 LaunchPoint。
单击 New 菜单并选择 New Service。 为您的服务提供一个描述性名称,然后从Service下拉菜单中选择 Custom。 提供描述,然后从API Only User下拉菜单中选择您的新用户并单击 Create。
单击新服务的 View Details 以访问客户端ID和客户端密钥。 现在,您可以单击 Get Token 按钮以生成一个有效期为一小时的访问令牌。 暂时将令牌保存在注释中。
接下来,转到 Admin 菜单,然后转到 Web Services。
暂时在REST API框中找到Endpoint并将其保存在注释中。
调用REST API方法时,必须在每次调用中包含访问令牌才能成功调用。 访问令牌必须作为HTTP标头发送。
Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int
打开新的浏览器选项卡并输入以下内容,使用适当的信息调用按筛选器类型获取潜在客户
<Your Endpoint URL>/rest/v1/leads.json?&filterType=email&filterValues=<Your Email Address>
如果您的数据库中没有包含电子邮件地址的潜在客户记录,请将其替换为您知道存在的潜在客户记录。 在URL栏中按Enter键,您应会获得与以下内容类似的JSON响应:
{
"requestId":"c493#1511ca2b184",
"result":[
{
"id":1,
"updatedAt":"2015-08-24T20:17:23Z",
"lastName":"Elkington",
"email":"developerfeedback@marketo.com",
"createdAt":"2013-02-19T23:17:04Z",
"firstName":"Kenneth"
}
],
"success":true
}
API 使用情况
每个API用户在API使用情况报表中单独报告,因此按用户拆分Web服务允许您轻松计算每个集成的使用情况。 如果对实例的API调用数量超过限制并导致后续调用失败,则使用此实践可让您考虑来自每个服务的数量,并让您评估如何解决此问题。 通过转到 Admin -> Integration > Web Services 并单击过去七天的呼叫数查看您的使用情况。