REST API
Marketo REST API提供对许多系统功能的远程访问。 您可以用它来创建项目、批量导入潜在客户以及在详细级别控制Marketo实例。
REST API分为两大类：
- 每日配额：每个订阅每天分配了50,000个API调用。 配额每天凌晨12:00 CST重置。 请与您的客户经理联系以增加每日配额。
- 速率限制：每个实例限制为每20秒100次API调用。
- 并发限制：每个实例最多允许10个并发API调用。
标准API调用的最大URI长度为8 KB，最大正文大小为1 MB。 批量API调用支持最大正文大小10 MB。
当调用包含错误时，API通常仍返回HTTP状态代码200。 JSON响应包含值为false的success成员以及errors成员中的错误数组。 此处提供了有关错误的详细信息。
快速入门
您需要具有Marketo实例管理员权限才能完成以下步骤。 此工作流会创建API凭据，并使用它们检索潜在客户记录。
首先，创建API用户并获取经过身份验证的调用的凭据。 登录您的实例，然后转到Admin > Users and Roles。
选择 Roles 选项卡，然后选择新建角色。 至少从访问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 以生成一个有效一小时的访问令牌。 保存第一个API调用的令牌。
转到Admin > Web Services。
在REST API框中找到Endpoint并将其保存以用于首次API调用。
每个REST API调用都必须在HTTP标头中包含访问令牌。
Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int
打开新的浏览器选项卡并输入以下URL。 将占位符替换为实例的终结点和电子邮件地址，以按筛选器类型调用获取潜在客户。
<Your Endpoint URL>/rest/v1/leads.json?&filterType=email&filterValues=<Your Email Address>
如果数据库不包含带有电子邮件地址的潜在客户记录，请使用现有潜在客户的电子邮件地址。 提交URL以接收类似于以下示例的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，然后选择过去七天中进行的呼叫数。
对于返回每日和最近7天使用情况和错误统计信息的REST端点，请参阅使用情况。