Comandi di richiesta HTTP

Una connessione HTTP Requests esegue questi comandi per eseguire le comuni richieste HyperText Transfer Protocol (HTTP) a un determinato URL per connettersi e automatizzare le soluzioni supportate attraverso i rispettivi connettori.

Per vedere come è strutturata una richiesta HTTP, consulta il nostro elenco di esempi di Connettori HTTP .

Nota: Sebbene questa sia etichettata come richiesta HTTP, l'HTTPS (Secure HTTP) è supportato (e consigliato).

Requisiti

Sebbene la connessione non abbia caratteristiche specifiche di OData, puoi aggiungere qualsiasi componente necessario della richiesta tramite i parametri Headers o Query string.
Per abilitare l'autenticazione reciproca TLS (mTLS), fornisci una coppia di chiavi pubbliche/private e, facoltativamente, un certificato CA. Per utilizzare le chiavi pubbliche e private, caricale come risorse dell'area di lavoro, quindi selezionale per i parametri Certificato e Chiave privata del comando.
Il file contenente la chiave privata non deve essere criptato. Il caricamento di un file crittografato come chiave privata provoca un errore.

Per abilitare questi comandi, un amministratore IT deve prima creare un connettore di richiesta HTTP.

Eliminare

Per rimuovere una risorsa, usa il comando Delete. Questo comando effettua una richiesta HTTP DELETE, ad esempio http://postman-echo.com/delete.

Proprietà

Proprietà	Dettaglio
Nome utente	Se è richiesta l'autenticazione di base, inserisci il nome utente.
Password	Se è richiesta l'autenticazione di base, inserisci la password.
Certificato CA	Inserisci il certificato dell'Autorità di Certificazione (CA) da utilizzare per effettuare la richiesta (opzionale).
Certificato	Inserisci il certificato da inviare con la richiesta (facoltativo). Se fornito, inserisci anche Chiave privata del certificato.
Chiave privata del certificato	Inserisci la chiave privata del certificato , se fornito.
Mostra la risposta	Per mostrare il corpo della risposta API nell'output, seleziona questa casella.
URL	Inserisci l'URL utilizzato per la richiesta, ad esempio `http://postman-echo.com/delete`.
Tipo di contenuto	Inserisci l'intestazione content-type da impostare. Specifica il formato previsto per l'invio del corpo della richiesta.
File corpo	Inserisci il file che contiene l'oggetto JSON o i parametri della richiesta da inviare nel corpo della richiesta. Se lo includi, lascia vuoto Testo del corpo.
Testo del corpo	Inserisci il testo da inviare nel corpo della richiesta. Se lo includi, lascia vuoto Body file.
Intestazioni	Inserisci eventuali intestazioni aggiuntive da aggiungere alla richiesta.

Output

Output	Tipo di output
Intestazioni della risposta	JSON
Risposta	File
Codice di risposta	Numero intero

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
2	Errore	Richiesta fallita; codice di risposta non-200
4	Errore	Certificato non trovato
5	Errore	Intestazioni della richiesta non valide

Ottieni

Per recuperare una risorsa, usa il comando Get. Questo comando effettua una richiesta HTTP GET, ad esempio https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Nota: Questo comando include uno spazio per inserire i parametri della query -- i parametri non devono essere inclusi nell'URL stesso. Se i parametri sono inseriti sia nell'URL che nel campo "Query string", verranno eliminati dall'URL.

Proprietà

Proprietà	Dettaglio
Nome utente	Se è richiesta l'autenticazione di base, inserisci il nome utente.
Password	Se è richiesta l'autenticazione di base, inserisci la password.
Certificato CA	Inserisci il certificato CA da utilizzare per effettuare la richiesta (facoltativo).
Certificato	Inserisci il certificato da inviare con la richiesta (facoltativo). Se fornito, inserisci anche Chiave privata del certificato.
Chiave privata del certificato	Inserisci la chiave privata del certificato , se fornito.
Mostra la risposta	Per mostrare il corpo della risposta API nell'output, seleziona questa casella.
URL	Inserisci l'URL utilizzato per la richiesta, ad esempio `https://postman-echo.com/get`.
Stringa di query	Inserisci la stringa di query da aggiungere alla richiesta, ad esempio `foo1=bar1&foo2=bar2`. Nota: La stringa di query deve essere codificata.
Intestazioni	Inserisci altre intestazioni da aggiungere alla richiesta.
Tipo di contenuto	Inserisci l'intestazione del tipo di contenuto da impostare, ad esempio `application/json`. Questo specifica il formato previsto per l'invio al corpo della richiesta.
Schema di output	Per consentire ai comandi successivi della catena di accedere alle proprietà di output di questo comando, inserisci un payload di esempio per ogni output JSON.

Output

Output	Tipo di output
Intestazioni della risposta	JSON
Risposta	File
Codice di risposta	Numero intero

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
2	Errore	Richiesta fallita; codice di risposta non-200
4	Errore	Certificato non trovato
5	Errore	Intestazioni della richiesta non valide

Pubblicare

Per inserire una risorsa, usa il comando Post. Questo comando effettua una richiesta HTTP POST, ad esempio https://postman-echo.com/post.

Proprietà

Proprietà	Dettaglio
Nome utente	Se è richiesta l'autenticazione di base, inserisci il nome utente.
Password	Se è richiesta l'autenticazione di base, inserisci la password.
Certificato CA	Inserisci il certificato CA da utilizzare per effettuare la richiesta (facoltativo).
Certificato	Inserisci il certificato da inviare con la richiesta (facoltativo). Se fornito, inserisci anche Chiave privata del certificato.
Chiave privata del certificato	Inserisci la chiave privata del certificato , se fornito.
Mostra la risposta	Per mostrare il corpo della risposta API nell'output, seleziona questa casella.
URL	Inserisci l'URL utilizzato per la richiesta, ad esempio `https://postman-echo.com/post`.
Tipo di contenuto	Inserisci l'intestazione content-type da impostare. Specifica il formato previsto per l'invio del corpo della richiesta. Nota: Per i dati in più parti, aggiungi Valori del modulo per generare il corpo.
File corpo	Inserisci il file che contiene l'oggetto JSON o i parametri della richiesta da inviare nel corpo della richiesta. Se lo includi, lascia vuoto Testo del corpo.
Testo del corpo	Inserisci il testo da inviare nel corpo della richiesta. Se lo includi, lascia vuoto Body file.
Intestazioni	Inserisci eventuali intestazioni aggiuntive da aggiungere alla richiesta.
Valori del modulo	Per generare il corpo dei dati in più parti, aggiungi i valori del modulo da includere nella richiesta e inserisci il nome e il valore di ciascuno. Se aggiungi dei valori di modulo, lascia vuoto Tipo di contenuto.
Schema di output	Per consentire ai comandi successivi della catena di accedere alle proprietà di output di questo comando, inserisci un payload di esempio per ogni output JSON.

Output

Output	Tipo di output
Intestazioni della risposta	JSON
Risposta	File
Codice di risposta	Numero intero

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
2	Errore	Richiesta fallita; codice di risposta non-200
4	Errore	Certificato non trovato
5	Errore	Intestazioni della richiesta non valide

Metti

Per modificare o aggiornare una risorsa, usa il comando Put. Questo comando effettua una richiesta HTTP PUT, ad esempio https://postman-echo.com/put.

Proprietà

Proprietà	Dettaglio
Nome utente	Se è richiesta l'autenticazione di base, inserisci il nome utente.
Password	Se è richiesta l'autenticazione di base, inserisci la password.
Certificato CA	Inserisci il certificato CA da utilizzare per effettuare la richiesta (facoltativo).
Certificato	Inserisci il certificato da inviare con la richiesta (facoltativo). Se fornito, inserisci anche Chiave privata del certificato.
Chiave privata del certificato	Inserisci la chiave privata del certificato , se fornito.
Mostra la risposta	Per mostrare il corpo della risposta API nell'output, seleziona questa casella.
URL	Inserisci l'URL utilizzato per la richiesta.
Tipo di contenuto	Inserisci l'intestazione content-type da impostare. Specifica il formato previsto per l'invio del corpo della richiesta. Nota: Per i dati in più parti, aggiungi Valori del modulo per generare il corpo.
File corpo	Inserisci il file che contiene l'oggetto JSON o i parametri della richiesta da inviare nel corpo della richiesta. Se lo includi, lascia vuoto Testo del corpo.
Testo del corpo	Inserisci il testo da inviare nel corpo della richiesta. Se lo includi, lascia vuoto Body file.
Intestazioni	Inserisci eventuali intestazioni aggiuntive da aggiungere alla richiesta.
Valori del modulo	Per generare il corpo dei dati in più parti, aggiungi i valori del modulo da includere nella richiesta e inserisci il nome e il valore di ciascuno. Se aggiungi dei valori di modulo, lascia vuoto Tipo di contenuto.
Schema di output	Per consentire ai comandi successivi della catena di accedere alle proprietà di output di questo comando, inserisci un payload di esempio per ogni output JSON.

Output

Output	Tipo di output
Intestazioni della risposta	JSON
Risposta	File
Codice di risposta	Numero intero

Codici di uscita

Codice	Tipo	Dettaglio
0	Operazione completata	Operazione completata
2	Errore	Richiesta fallita; codice di risposta non-200
4	Errore	Certificato non trovato
5	Errore	Intestazioni di richiesta non valide

Assistenza

Community

Centro assistenza di Workiva