在 Workiva 中,產生存取令牌(特別是 OAuth2 不記名令牌)是一個分兩步的流程:您首先建立 API 授與以取得憑證,然後再使用這些憑證要求實際的令牌。
1.建立 API 授與
重要事項: 您必須是工作區擁有者才能執行此步驟。
要取得客戶 ID 與機密:
- 按一下 Workiva 頁面右上角的您的 ID 圖示,然後選取 Workspace 設定。
- 選取 「安全性」 索引標籤,然後按一下 「建立 API 授予」。
- 在 「更新授予」(Update Grant) 頁面上,填寫以下欄位:
- 輸入 客戶名稱 和授權將代表的 Workiva 使用者名稱 。
- 選取「OAuth2 Client Credentials」作為 Client Type。
- 為您計劃使用的 API 端點選取所需的 範圍 (權限)。
- 設定「 過期」(Expires) 日期。
- 除非組織特別要求,否則您可以忽略 「Ip 允許清單」 欄位。
- 按一下 「新增授與」。
重要事項: 請立即復制用戶端 ID 和用戶端密碼,因為密碼不會再顯示。
2.擷取承載者標記
獲得憑證後,必須向 Workiva IAM 服務發出 POST 請求,以將憑證交換為短期存取權杖。
- 端點:
https://api.app.wdesk.com( 是美國的預設設定; 其他地區有不同的端點)。 - Content Type: 將
Content-Type設定為Application/json。 - 頁首:新增
X 版本:2026-01-01 - 表單值:
-
Grant_type:client_credentials -
client_id:[Your Client ID] -
client_secret:[Your Client Secret] -
範圍:鏈結
-
- 到期日: Workiva 不記名權杖的有效期通常為 10 分鐘。對於長期間執行的流程,您必須定期重新整理。
SEC EDGAR 下一步/下一個代碼
如果您要產生 專門為 SEC 申報 (EDGAR Next) 的權杖,則這些權杖與標準 API 權杖不同:
- 這些 Token (Filer API Token 和 User Token) 是在 SEC 的 EDGAR Filer Management Dashboard上建立的。
- 獲取後,您可在 Workiva 的 SEC Reporting > Manage EDGAR Next Tokens 下一步/下一個代碼中管理它們。