文件Marketo 開發人員指南

REST API

最後更新： 2026年5月13日

建立對象：

  • {"id":"c66ffd68-0f65-42bb-aa23-b4020f12e0bd"}

Marketo REST API可讓您從遠端存取許多系統功能。 您可以用它來建立程式、大量匯入銷售機會，以及在詳細層級控制Marketo執行個體。

REST API分為兩大類：

  • 潛在客戶資料庫 API會擷取並與Marketo人員記錄和相關物件型別（例如商機和公司）互動。
  • 資產 API與行銷宣傳品和工作流程相關記錄互動。
NOTE
SOAP API即將淘汰，自2026年7月31日起將不再提供使用。 所有新的開發應使用Marketo REST API完成，而現有服務應於該日期前移轉，以避免服務中斷。 如果您有使用SOAP API的服務，請參閱SOAP API 移轉指南以瞭解如何移轉的資訊。
IMPORTANT
請參閱此Nation貼文，瞭解API閘道URL中雙斜線是否被取代。
  • 每日配額：​每個訂閱每天都會分配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。

新的Launchpoint服務

選取新服務的​ View Details ​以存取使用者端ID和使用者端密碼。 選取​ Get Token ​以產生一小時有效的存取權杖。 儲存第一個API呼叫的Token。

取得Token

前往​Admin > Web Services。

網站服務

在REST API方塊中尋找Endpoint並儲存以供第一個API呼叫使用。

REST端點

每個REST API呼叫都必須在HTTP標頭中包含存取權杖。

Authorization: Bearer cdf01657-110d-4155-99a7-f986b2ff13a0:int
IMPORTANT
自2025年6月30日起，將移除對使用​ access_token ​查詢引數的驗證支援。 如果您的專案使用查詢引數來傳遞存取Token，則應儘快更新以使用​ Authorization ​標頭。 新開發應專門使用​ Authorization ​標頭。

開啟新的瀏覽器索引標籤，然後輸入下列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端點，請參閱使用量。

recommendation-more-help
marketo-developer-help