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

新Launchpoint服务

单击新服务的​ View Details ​以访问客户端ID和客户端密钥。 现在,您可以单击​ Get Token ​按钮以生成一个有效期为一小时的访问令牌。 暂时将令牌保存在注释中。

获取令牌

接下来,转到​ Admin ​菜单,然后转到​ Web Services

Web服务

暂时在REST API框中找到Endpoint并将其保存在注释中。

REST终结点

调用REST API方法时,必须在每次调用中包含访问令牌才能成功调用。 访问令牌必须作为HTTP标头发送。

Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int
IMPORTANT
2025年6月30日,将移除对使用​ access_token ​查询参数的身份验证的支持。 如果您的项目使用查询参数来传递访问令牌,则应尽快更新以使用​ Authorization ​标头。 新开发应仅使用​ Authorization ​标头。

打开新的浏览器选项卡并输入以下内容,使用适当的信息调用按筛选器类型获取潜在客户

<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 ​并单击过去七天的呼叫数查看您的使用情况。

recommendation-more-help
bb269a6d-047a-4bf7-9acd-23ad9a63dc59