1. 创建 API Only 用户
1.1 登录到 Marketo 实例
使用管理员权限登录到你的 Marketo 帐户。
1.2 导航到 Admin 页面
在主菜单中,点击 “Admin”。
1.3 创建 API Only 用户
- 在左侧菜单中,找到并点击 “Users & Roles”。
- 在右侧,点击 “Invite New User” 按钮。
- 填写用户信息,如名字和电子邮件地址。
- 在 “Roles” 部分,选择 “API Only” 角色。
- 确认 “API Only” 复选框已勾选。
- 点击 “Next” 完成邀请。
1.4 激活用户
用户会收到一封激活邮件。点击邮件中的激活链接完成用户激活过程。
2. 创建 LaunchPoint 服务
2.1 导航到 LaunchPoint
在 Admin 页面左侧菜单中,找到并点击 “LaunchPoint”。
2.2 创建新服务
- 点击 “New” 按钮,然后选择 “New Service”。
- 在弹出的对话框中,填写以下信息:
- Display Name: 服务的显示名称。
- Service: 选择 “Custom”。
- Description: 简要描述服务的用途。
- API Only User: 选择之前创建的 API Only 用户。
- 点击 “Create” 按钮完成创建。
3. 获取 API 凭证
3.1 查看 Web Services
在 Admin 页面左侧菜单中,找到并点击 “Web Services”。这里你可以看到你的 REST API Endpoint 和 SOAP API Endpoint 信息。
3.2 记录 Client ID 和 Client Secret
在 LaunchPoint 页面中,找到你刚才创建的服务,点击服务名称。你会看到 “Client ID” 和 “Client Secret” 信息。记录下这些凭证,它们将在 API 请求中使用。
4. 获取访问令牌
4.1 构建请求 URL
使用你的 REST API Endpoint 构建请求 URL:
https://<your_instance>.mktorest.com/identity/oauth/token?grant_type=client_credentials&client_id=<Client_ID>&client_secret=<Client_Secret>
4.2 发送请求
使用 curl 或其他 HTTP 客户端工具发送请求:
curl -X POST \ 'https://<your_instance>.mktorest.com/identity/oauth/token?grant_type=client_credentials&client_id=<Client_ID>&client_secret=<Client_Secret>'
4.3 处理响应
请求成功后,会返回一个 JSON 响应,其中包含访问令牌:
{ "access_token": "your_access_token", "token_type": "bearer", "expires_in": 3600 }
5. 使用访问令牌调用 API
5.1 构建 API 请求
使用你的 REST API Endpoint 构建请求 URL:
https://<your_instance>.mktorest.com/rest/v1/leads.json?access_token=<Access_Token>&filterType=email&filterValues=example@example.com
5.2 发送请求
使用 curl 或其他 HTTP 客户端工具发送请求:
curl -X GET \ 'https://<your_instance>.mktorest.com/rest/v1/leads.json?access_token=<Access_Token>&filterType=email&filterValues=example@example.com'
5.3 处理响应
请求成功后,会返回一个 JSON 响应,其中包含潜在客户记录的信息。