簡介
在使用鏈結進行多個帶有過期認證標記的 API 呼叫時（如 Workiva API 使用的鏈結），存在標記可能在所有呼叫初始化之前過期的風險。如果發生這種情況，任何剩餘的 API 調用都會失敗。在每次 API 呼叫之前重新驗證可以避免此問題，但會為鏈結新增額外開銷。
本指南說明如何動態重新整理 OAuth 令牌範本。此範本適用於使用 HTTP 連接器進行 API 呼叫的 Chains（自動化工作流程），其中 API 要求透過具有到期日期和時間的令牌進行驗證。雖然它是為 Workiva API 而建，但也可適用於使用類似驗證方法的其他 API。
Chains（自動化工作流程）包括一個機制，可以在代幣接近過期時自動重新整理代幣。它從現有令牌的到期時間中減去 2 分鐘（此值可調整）作為緩衝，並將其與當前時間進行比較。如果當前時間遲於調整後的到期時間，Chains（自動化工作流程）會觸發重新驗證流程以產生新的代碼，然後由鏈輸出。如果令牌仍然有效，Chains（自動化工作流程）會跳過重新驗證，直接輸出現有的令牌。
附註：如果沒有任何令牌傳送到此鏈結，則它會自動通過認證流程並產生一個令牌，這意味著此鏈結還可用於我們的初始化（第一個）認證請求以及任何後續請求。
必要條件
鏈結
您的工作區必須啟用和設定下列連線器：
範本包含下列工作區變數 專為與 Workiva API 搭配使用而設計，請視情況變更與組態：
- wsv_platform (您的工作區所在的應用程式位置，美國地區使用 "app「，歐盟/歐洲、中東及非洲地區使用 」eu「，亞太地區使用 」apac")
- wsv_Client ID (您的 API 授與的用戶端 ID)
- wsv_Client Secret (您的 API 授權與機密)
部署鏈
Reresh OAuth Tokens Dynamically" Chains Template 位於模板畫面的 Workiva Chains 區段 (UI)/章節。
以下是如何找到它：
- 在 Chain Builder 中，移至Templates 選項卡
- 從上方選單選擇Workiva Chains
- 在右上方搜尋「Refresh OAuth Tokens Dynamically Chains（自動化工作流程）」並開啟範本。
- 找到範本後，按一下New Chain 將其部署到您的工作區。
- 為您的工作區和 API 配置範本。
- 請記住，一旦配置好 Chains（自動化工作流程），如果您希望不做任何修改，就按原樣使用，則必須發佈該鏈結。
附註： 從範本建立 Chains（自動化工作流程）的詳細說明，請參閱建立與管理 Chains 文章。
配置模板
此範本可使用「執行 Chains」命令新增至現有的 Chains（自動化工作流程），且不需額外修改 Workiva API 即可運作。有關如何使用「執行 Chains（自動化工作流程）」事件命令的說明，請參閱此處。
此 Chains（自動化工作流程）的使用範例是在使用迭代器的現有命令群組中。此 Chains（自動化工作流程）可從「Run Chain」事件命令執行，並在群組中有自己的分支，設定動態 Chain 變數 與此 Chains（自動化工作流程）的 Chain 輸出。
在 「Run Chains（自動化工作流程）」命令中，您可以使用您的動態鏈變數，以確保它始終是被檢查的最新令牌。
然後，您需要使用「執行 Chains」命令的輸出更新相同的動態鏈結變數。
然後，您可以在任何 HTTP 要求者命令中使用相同的動態鏈結變數。
更新緩衝時間
預設情況下，此範本會新增 2 分鐘緩衝時間到現有代用幣的到期時間，以避免任何時間問題。您可以在「檢查有效日期時間是否關閉」條件命令中變更。
編輯此命令後，雙擊條件中的第一個「進階查詢 - 轉換時間戳記 - 時間戳記」變數。
然後，您可以依喜好調整金額值。