HTTP > Make an API Key Authorization request

Questo modulo di azione Adobe Workfront Fusion invia una richiesta HTTPS a un URL specificato che richiede un'autorizzazione di autenticazione della chiave API ed elabora la risposta.

NOTE
Se ti connetti a un prodotto Adobe che al momento non dispone di un connettore dedicato, ti consigliamo di utilizzare il modulo Adobe Authenticator.
Per ulteriori informazioni, vedere Modulo Adobe Authenticator.

Requisiti di accesso

Espandi per visualizzare i requisiti di accesso per la funzionalità in questo articolo.

Per utilizzare le funzionalità di questo articolo, è necessario disporre dei seguenti diritti di accesso:

table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto html-authored no-header
Pacchetto Adobe Workfront Qualsiasi
Licenza Adobe Workfront

Nuovo: Standard

Oppure

Corrente: Lavoro o versione successiva

Licenza Adobe Workfront Fusion**

Corrente: nessun requisito di licenza Workfront Fusion.

Oppure

Legacy: Workfront Fusion per l'automazione e l'integrazione del lavoro

Prodotto

Nuovo:

  • Seleziona o crea un pacchetto Prime Workfront: la tua organizzazione deve acquistare Adobe Workfront Fusion.
  • Pacchetto Ultimate Workfront: è incluso Workfront Fusion.

Oppure

Corrente: la tua organizzazione deve acquistare Adobe Workfront Fusion.

Per ulteriori dettagli sulle informazioni contenute in questa tabella, vedere Requisiti di accesso nella documentazione.

Per informazioni sulle Adobe Workfront Fusion licenze, vedere Adobe Workfront Fusion licenze.

Configurazione modulo HTTP > Make an API Key Authorization request

Quando configuri il modulo HTTP > Make an API Key Authorization request, Adobe Workfront Fusion visualizza i campi elencati di seguito. Un titolo in grassetto in un modulo indica un campo obbligatorio.

Se viene visualizzato il pulsante Mappa sopra un campo o una funzione, è possibile utilizzarlo per impostare variabili e funzioni per tale campo. Per ulteriori informazioni, vedere Mappare le informazioni da un modulo all'altro in Adobe Workfront Fusion.

Attiva/Disattiva mappa

Credentials

Seleziona la chiave che contiene le credenziali di autenticazione della chiave API. Per aggiungere una nuova chiave, fare clic su Add e configurare le informazioni seguenti:

  • Key name

    Immetti un nome per questo set di credenziali API.

  • Key

    Immetti la chiave API.

  • API Key placement

    Seleziona se inserire la chiave API nell’intestazione o nella query della chiamata API.

  • API Key parameter name

    Immetti il nome con cui la chiamata API identifica la chiave API, ad esempio "apiKey" o "X-API-Key". Queste informazioni sono disponibili nella documentazione del servizio web a cui il modulo si connette.

Evaluate all states as errors (except for 2xx and 3xx)

Utilizza questa opzione per configurare la gestione degli errori.

Per ulteriori informazioni, vedere Gestione degli errori.

URL
Immetti l’URL a cui desideri inviare una richiesta, ad esempio un endpoint API, un sito web, ecc.
Method
Seleziona il metodo di richiesta HTTP necessario per configurare la chiamata API. Per ulteriori informazioni, vedere Metodi di richiesta HTTP.
Headers
Aggiungi le intestazioni della richiesta sotto forma di oggetto JSON standard. Ad esempio: {"Content-type":"application/json"}
Query String
Immetti le coppie chiave-valore di query desiderate.
Body type

Il corpo HTTP è costituito dai byte di dati trasmessi in un messaggio di transazione HTTP immediatamente dopo le intestazioni, se ve ne sono altre da utilizzare.

  • Raw

    Il tipo di corpo Raw è generalmente adatto per la maggior parte delle richieste HTTP body, anche in situazioni in cui la documentazione per gli sviluppatori non specifica i dati da inviare.

    Specificare una forma di analisi dei dati nel campo Content type.

    Nonostante il tipo di contenuto selezionato, il modulo immette i dati in qualsiasi formato stabilito o richiesto dalla documentazione per gli sviluppatori.

  • Application/x-www-form-urlencoded

    Questo tipo di corpo è POST dati utilizzando application/x-www-form-urlencoded.

    Per application/x-www-form-urlencoded, il corpo del messaggio HTTP inviato al server è essenzialmente una stringa di query. Le chiavi e i valori sono codificati in coppie chiave-valore separate da & e con un = tra la chiave e il valore.

    Per i dati binari, utilizzare multipart/form-data.

    Esempio:

    Esempio del formato di richiesta HTTP risultante:

    field1=value1&field2=value2

  • Multipart/form-data

    Multipart/form-data è una richiesta HTTP multipart utilizzata per inviare file e dati. Viene comunemente utilizzato per caricare file sul server.

    Aggiungi i campi da inviare nella richiesta. Ogni campo deve contenere una coppia chiave-valore.

    • Text

      Immetti la chiave e il valore da inviare nel corpo della richiesta.

    • File

      Immetti la chiave e specifica il file di origine da inviare nel corpo della richiesta.

      Mappare il file che si desidera caricare dal modulo precedente (ad esempio HTTP > Get a File o Google Drive >Download a File) oppure immettere manualmente il nome del file e i dati del file.

Parse response

Abilita questa opzione per analizzare automaticamente le risposte e convertire le risposte JSON e XML in modo da non dover utilizzare i moduli JSON > Parse JSON o XML > Parse XML.

Prima di poter utilizzare contenuti JSON o XML analizzati, esegui il modulo una volta manualmente in modo che possa riconoscere il contenuto della risposta e consentirti di mapparlo nei moduli successivi.

Timeout
Specifica il timeout della richiesta in secondi (1-300). Il valore predefinito è 40 secondi.
Share cookies with other HTTP modules
Abilita questa opzione per condividere i cookie dal server con tutti i moduli HTTP nel tuo scenario.
Self-signed certificate

Per aggiungere un certificato autofirmato:

  1. Fare clic su Extract.

  2. Selezionare il tipo di file da estrarre.

  3. Seleziona il file che contiene il certificato o.

  4. Immettere la password per il file.

  5. Fare clic su Save per estrarre il file e tornare alla configurazione del modulo.

Reject connections that are using unverified (self-signed) certificates
Abilita questa opzione per rifiutare le connessioni che utilizzano certificati TLS non verificati.
Follow redirect
Abilita questa opzione per seguire i reindirizzamenti URL con risposte 3xx.
Follow all redirects
Abilita questa opzione per seguire i reindirizzamenti URL con tutti i codici di risposta.
Disable serialization of multiple same query string keys as arrays
Per impostazione predefinita, Workfront Fusion gestisce più valori per la stessa chiave di parametro della stringa di query URL come array. Ad esempio, www.test.com?foo=bar&foo=baz verrà convertito in www.test.com?foo[0]=bar&foo[1]=baz. Attiva questa opzione per disabilitare questa funzione.
Request compressed content

Abilita questa opzione per richiedere una versione compressa del sito web.

Aggiunge un'intestazione Accept-Encoding per richiedere contenuto compresso.

Use Mutual TLS

Abilita questa opzione per utilizzare Mutual TLS nella richiesta HTTP.

Per ulteriori informazioni su Mutual TLS, vedere Utilizzare Mutual TLS nei moduli HTTP in Adobe Workfront Fusion.

recommendation-more-help
7e1891ad-4d59-4355-88ab-a2e62ed7d1a3