Authentication

最後更新： 2026年5月13日

主題：
REST API

建立對象：

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

Marketo REST API使用2腿OAuth 2.0進行驗證。自訂服務提供用於取得存取權杖的使用者端ID和使用者端密碼。

每個自訂服務都屬於僅限API的使用者。使用者的角色和許可權可授權服務執行特定動作。存取權杖屬於單一自訂服務，其到期日與執行個體中其他自訂服務的權杖無關。

建立存取Token

若要尋找Client ID和Client Secret，請移至Admin > Integration > LaunchPoint。選取自訂服務，然後選取View Details。

取得REST服務詳細資料

啟動點認證

若要尋找Identity URL，請前往Admin > Integration > Web Services。 URL會顯示在REST API區段中。

使用HTTP GET或POST要求建立存取權杖：

GET <Identity URL>/oauth/token?grant_type=client_credentials&client_id=<Client Id>&client_secret=<Client Secret>

如果您的請求有效，您會收到類似以下的JSON回應：

{
    "access_token": "cdf01657-110d-4155-99a7-f986b2ff13a0:int",
    "token_type": "bearer",
    "expires_in": 3599,
    "scope": "apis@acmeinc.com"
}

回應包含下列欄位：

access_token：您在後續呼叫中傳遞的Token，以驗證目標執行個體。
token_type： OAuth驗證方法。
expires_in：目前權杖的剩餘有效期限（以秒為單位）。新的存取權杖的有效期限為3,600秒或1小時。
scope：擁有用於驗證的自訂服務的使用者。

使用存取權杖

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

IMPORTANT

2026年8月31日將移除使用access_token查詢引數的驗證支援。如果您的專案使用查詢引數來傳遞存取Token，應儘快更新以使用授權標頭。新開發應僅使用Authorization標頭。

切換至Authorization標題

若要以Authorization標頭取代access_token查詢引數，請更新要求傳送權杖的方式。

下列cURL範例將access_token值傳送為含有-F旗標的表單引數：

curl ...  -F access_token=<Access Token> <REST API Endpoint Base URL>/bulk/v1/apiCall.json

下列範例會在Authorization: Bearer HTTP標頭中傳送具有-H旗標的相同值：

curl ... -H 'Authorization: Bearer <Access Token>' <REST API Endpoint Base URL>/bulk/v1/apiCall.json

提示和最佳實務

儲存身分回應的存取權杖和到期日。管理權杖到期有助於防止在正常操作期間發生未預期的驗證錯誤。

在進行REST呼叫之前，請檢查權杖的剩餘期限。如果權杖已過期，請呼叫身分端點以更新權杖。主動更新可防止權杖過期所導致的失敗，並讓REST呼叫延遲更可預測，這對於面向使用者的應用程式非常重要。

驗證錯誤傳回下列程式碼：

602：存取權杖已過期。
601：存取權杖無效。

如果使用者端收到任一程式碼，請呼叫身分識別端點以續約權杖。

如果您在權杖過期之前呼叫身分端點，則回應會傳回相同的權杖及其剩餘期限。

存取權杖屬於自訂服務，而非使用者。如果來自兩個不同服務的憑證產生範圍設定為相同使用者的身分回應，則其存取權杖和到期日將維持獨立。

當應用程式使用多個認證集時，請使用使用者端ID作為金鑰，以獨立管理每個權杖。

recommendation-more-help

marketo-developer-help