HTTP > Crea una richiesta di autorizzazione della chiave API

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:

• Nome chiave

  Immetti un nome per questo set di credenziali API.

• Key

  Immetti la chiave API.

• Posizionamento chiave API

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

• API Nome parametro chiave

  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.

Valuta tutti gli stati come errori (tranne 2xx e 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"}

Stringa Di Query

Immetti le coppie chiave-valore di query desiderate.

Tipo di corpo

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 un tipo 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 è nei dati POST che utilizzano 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 multipart HTTP 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.

  • Testo

    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.

    Mappa il file che desideri caricare dal modulo precedente (ad esempio HTTP > Ottieni un file o Google Drive >Scarica un file) oppure immetti manualmente il nome del file e i dati del file.

Analizza risposta

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.

Condividi i cookie con altri moduli HTTP

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 Salva per estrarre il file e tornare alla configurazione del modulo.

Rifiuta le connessioni che utilizzano certificati non verificati (autofirmati)

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.

Segui tutti i reindirizzamenti

Abilita questa opzione per seguire i reindirizzamenti URL con tutti i codici di risposta.

Disattiva la serializzazione di più chiavi di stringa di query come matrici

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.

Richiedi contenuto compresso

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

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

Usa TLS reciproco

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.