取得OAuth2 Token

最後更新： 2024年7月18日

建立對象：

傳回已驗證使用者的OAuth2重新整理權杖和存取權杖。當使用者布建檔案提供者時，就會叫用一次。進行後續呼叫以取得更新的存取Token。

URL

POST/any/url

URL可設定，並與自訂整合設定頁面上的權杖端點URL值相對應。

姓名	必要	說明
grant_type	是	值包括「authorization_code」或「refresh_token」。指定的值表示將傳遞至此API呼叫的兩個引數之一： code或refresh_token。
程式碼	根據	使用者按一下「授予」按鈕後就會傳送至Adobe Workfront的授權代碼。僅當授權型別為「authorization_code」時才需要此項。授權碼應為短期，通常在10分鐘或更短時間內到期。
refresh_token	根據	只有在進行後續呼叫以擷取新的access_token時才需要此專案，因為先前的access_token已過期。傳送此值時，請將grant_type引數設為"refresh_token"。
client_id	是	在Workfront中針對此自訂整合設定的使用者端ID。
client_secret	是	Workfront中針對此自訂整合設定的使用者端密碼。

回應

姓名	型別	說明
access_token	字串	代號，用來代表使用者進行授權的API呼叫。此專案應該會過期，以防止未經授權的API呼叫。
refresh_token	字串	長效權杖，用於透過呼叫此API方法擷取新的access_token。
expires_in	長	（選用） access_token過期前的時間（以秒為單位），通常為3,600。

範例

POST /oauth2/token
grant_type=authorization_code
code=d9ac7asdf6asdf579d7a8
client_id=123456
client_secret=6asdf7a7a9a4af

{
access_token:"ad8af5ad5ads759",
refresh_token:"9a0h5d87d808ads",
expires_id:3600
}

recommendation-more-help