Questa guida illustra come importare le raccolte API di Workiva in Bruno utilizzando le specifiche OpenAPI. Imparerete a configurare le variabili d'ambiente globali, ad autenticarvi con OAuth 2.0 e a convalidare le richieste API end-to-end.
Prerequisiti
- Scaricare e installare Bruno da www.usebruno.com .
Background
Le API di Workiva sono pubblicate in formato OpenAPI (.yaml). Queste specifiche possono essere importate direttamente nei client API come Bruno, consentendo di lavorare con collezioni completamente strutturate senza costruire manualmente le richieste.
Passo 1: Importare la raccolta API di Workiva
- Accedere alla pagina Workiva Platform Code Generation .
- Scaricare il file OpenAPI
.yaml. -
Aprire Bruno. Nell'angolo in alto a sinistra, fare clic sul menu con i tre puntini e selezionare Importa collezione.
-
Selezionare il file OpenAPI V3 e scegliere il file
.yamlscaricato. -
Quando viene richiesto, creare o selezionare una cartella locale in cui Bruno memorizzerà la raccolta (ad esempio, Bruno Collections).
Passo 2: Configurazione dell'ambiente globale
-
Nell'angolo in alto a destra di Bruno, fare clic sull'icona del globo e selezionare Configura.
- Scegliete Create Global Environment.
- Creare le seguenti variabili globali:
access_tokenAmbienteClientIDClientSecretapi_version
-
Popolare i valori di
Environment,ClientID, eClientSecret. Lasciare vuotoaccess_tokene impostareapi_versiona2026-01-01. - Salviamo l'ambiente.
Passo 3: Configurare OAuth 2.0 - Recuperare un token
Per riutilizzare l'autenticazione in più collezioni, il token di accesso OAuth sarà memorizzato come variabile d'ambiente globale .
- Selezionare la raccolta Workiva API.
- Seleziona la scheda Variables.
-
Aggiorna la variabile
baseUrlper utilizzare{{environment}}invece di un dominio codificato.Originale:
https://api.app.wdesk.comAggiornato:
https://api.{{ambiente}}.wdesk.com - Impostare l'autorizzazione su Bearer Token e usare la variabile
{{access_token}}. - Selezionare la scheda Scripts.
-
Aggiungere il seguente script alla sezione Pre-request.
Per 2026 Platform API, l'intestazione X-Version è richiesta su ogni richiesta. Questo script assicura che l'intestazione sia applicata in modo coerente in tutta la raccolta, in linea con i requisiti di versionamento dell'API 2026 di Workiva.
Nota: Questo requisito si applica attualmente solo alle API di piattaforma.
// Aggiungere o aggiornare l'intestazione X-Version (Bruno) req.setHeader("X-Version", bru.getGlobalEnvVar("api_version")); - Nella raccolta API di Workiva, navigare nella cartella oauth2 e aprire Retrieve a token.
-
Nella sezione dello script Post Response, aggiungere quanto segue per salvare il token a livello globale:
const body = res.getBody(); bru.setGlobalEnvVar("access_token", body.access_token); - Salva le modifiche.
Passo 4: Generare un gettone portatore
- Nel corpo della richiesta OAuth2, impostare:
{{ClientID}}{{ClientSecret}}
- Inviare la richiesta Recuperare un token.
-
In caso di successo, la risposta includerà un token Bearer che verrà salvato automaticamente come variabile globale .
È ora possibile inviare richieste autenticate. In caso di successo, la risposta restituirà l'elenco dei documenti.
Passo 5: Importare e configurare la raccolta API Wdata e Chains
- Andate alla pagina Wdata Code Generation.
- Scaricare il file
.yamle importarlo in Postman (Seguire la procedura descritta in Passo 1: Importare la raccolta API di Workiva). Nota: Il nome del file.yamlsarà probabilmente lo stesso della Workiva API Collection. - Nella raccolta Wdata :
- Seleziona la scheda Variables.
-
Aggiorna la variabile
baseUrlper utilizzare{{environment}}invece di un dominio codificato.Originale:
https://h.app.wdesk.com/s/wdata/oc/apiAggiornato:
https://h.{{ambiente}}.wdesk.com/s/wdata/prep - Impostare l'autorizzazione su Bearer Token e usare la variabile
{{access_token}}. - Ripetere gli stessi passi sopra descritti per la Chains API Collection, assicurandosi che le impostazioni di autorizzazione e la variabile
baseUrlsiano configurate allo stesso modo.
Risoluzione dei problemi
- Assicurati di fare riferimento all'ambiente corretto. Se la collezione ha come impostazione predefinita l'ambiente No, passa a l'ambiente specificato.
- Verifica che la variabile
baseUrlsia coerente con le impostazioni dell'ambiente e della collezione. - Assicurati di impostare la variabile di raccolta
baseUrlper utilizzare{{environment}}; in caso contrario, le tue richieste potrebbero fallire. - Se la richiesta restituisce una risposta 401 o vuota, ricontrollare che i valori di Client ID, Client Secret, API_version e Environment siano corretti.