I Workiva är generering av en åtkomsttoken (specifikt en OAuth2-bärartoken) en tvåstegsprocess: du skapar först ett API-tillstånd för att hämta autentiseringsuppgifter och använder sedan dessa autentiseringsuppgifter för att begära själva token.
1. Skapa ett API-bidrag
Viktigt: Du måste vara arbetsyteägare för att utföra det här steget.
För att få ett klient-ID och en hemlighet:
-
Klicka på din ID-ikon i det övre högra hörnet på Workiva-sidan och välj sedan Arbetsyteinställningar .
- Välj fliken Säkerhet och klicka sedan på Skapa API-tilldelning .
-
På sidan Uppdatera bidrag fyller du i följande fält:
- Ange ett klientnamn och det Workiva-användarnamn som bidragsgivaren ska agera på uppdrag av.
- Välj "OAuth2-klientuppgifter" som klienttyp .
- Välj de omfång (behörigheter) som krävs för de API-slutpunkter du planerar att använda.
- Ange utgångsdatum .
- Om inte din organisation uttryckligen kräver det kan du ignorera fältet för tillåtelselista för IP-adresser .
- Klicka på Lägg till bidrag .
Viktigt: Kopiera klient-ID och klienthemlighet omedelbart, eftersom hemligheten inte kommer att visas igen.
2. Hämta Bearer-token
När du har dina inloggningsuppgifter måste du byta ut dem mot en kortvarig åtkomsttoken genom att göra en POST- begäran till Workiva IAM-tjänsten.
- Slutpunkt
:https://api.app.wdesk.com (är standard för USA; andra regioner har andra slutpunkter ). -
Innehållstyp: Ställ in innehållstypen tillapplication/json. - Rubriker: Lägg till
X-version:2026-01-01 - Formulärvärden:
-
: klientreferenserbeviljandetyp -
klient_id :[Your Client ID] -
klienthemlighet :[Your Client Secret] -
Omfattning: Kedjor
-
- Utgångsdatum: Workiva-bärartokens är vanligtvis giltiga i 10 minuter. Du måste regelbundet uppdatera dem för långvariga processer.
SEC EDGAR Nästa Tokens
Om du genererar tokens specifikt för SEC-anmälan (EDGAR Next) skiljer sig dessa från vanliga API-tokens: