Una connessione HTTP Requests esegue questi comandi per eseguire richieste HyperText Transfer Protocol (HTTP) comuni a un determinato URL per connettersi e automatizzare le soluzioni supportate attraverso i rispettivi connettori.
Per vedere come è strutturata una richiesta HTTP, consultare l'elenco di esempi del connettore HTTP .
Requisiti
- Sebbene la connessione non abbia caratteristiche specifiche di OData, è possibile aggiungere qualsiasi componente necessario della richiesta tramite i parametri Headers o Query string.
- Per abilitare l'autenticazione reciproca TLS (mTLS), fornire una coppia di chiavi pubbliche/private e, facoltativamente, un certificato CA. Per utilizzare le chiavi pubbliche e private, caricarle come risorse dell'area di lavoro, quindi selezionarle per i parametri Certificate e Certificate private key del comando, rispettivamente.
Per abilitare questi comandi, un amministratore IT deve innanzitutto creare un connettore HTTP Request.
Cancellare
Per rimuovere una risorsa, utilizzare il comando Delete. Questo comando effettua una richiesta HTTP DELETE
, come http://postman-echo.com/delete
.
Proprietà
Proprietà |
Dettaglio |
Nome utente |
Se è richiesta l'autenticazione di base, inserire il nome utente. |
Password |
Se è richiesta l'autenticazione di base, inserire la password. |
Certificato CA |
Inserire il certificato dell'Autorità di certificazione (CA) da utilizzare per la richiesta (opzionale). |
Certificato |
Inserire il certificato da inviare con la richiesta (opzionale). Se previsto, inserire anche Chiave privata del certificato. |
Chiave privata del certificato |
Inserire la chiave privata del certificato , se fornita. |
Mostra la risposta |
Per mostrare il corpo della risposta API nell'output, selezionare questa casella. |
URL |
Inserire l'URL utilizzato per la richiesta, ad esempio http://postman-echo.com/delete . |
Tipo di contenuto |
Immettere l'intestazione del tipo di contenuto da impostare. Specifica il formato previsto da inviare al corpo della richiesta. |
File corpo |
Inserire il file che contiene l'oggetto JSON o i parametri della richiesta da inviare nel corpo della richiesta. Se lo si include, lasciare vuoto Body text. |
Testo del corpo |
Inserire il testo da inviare nel corpo della richiesta. Se lo si include, lasciare vuoto il file Body. |
Intestazioni |
Inserire eventuali intestazioni aggiuntive da aggiungere alla richiesta. |
Uscite
Uscita |
Tipo di uscita |
Intestazioni di risposta |
JSON |
Risposta |
File |
Codice di risposta |
Intero |
Codici di uscita
Codice |
Tipo |
Dettaglio |
0 |
Il successo |
Il successo |
2 |
Errore |
Richiesta fallita; codice di risposta non-200 |
4 |
Errore |
Certificato non trovato |
5 |
Errore |
Intestazioni della richiesta non valide |
Ottenere
Per recuperare una risorsa, utilizzare il comando Get. Questo comando effettua una richiesta HTTP GET
, come 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, inserire il nome utente. |
Password |
Se è richiesta l'autenticazione di base, inserire la password. |
Certificato CA |
Inserire il certificato CA da utilizzare per la richiesta (opzionale). |
Certificato |
Inserire il certificato da inviare con la richiesta (opzionale). Se previsto, inserire anche Chiave privata del certificato. |
Chiave privata del certificato |
Inserire la chiave privata del certificato , se fornita. |
Mostra la risposta |
Per mostrare il corpo della risposta API nell'output, selezionare questa casella. |
URL |
Inserire l'URL utilizzato per la richiesta, ad esempio https://postman-echo.com/get . |
Stringa di query |
Inserire la stringa di query da aggiungere alla richiesta, ad esempio foo1=bar1&foo2=bar2 . Nota: La stringa di query deve essere codificata. |
Intestazioni |
Inserire eventuali intestazioni aggiuntive da aggiungere alla richiesta. |
Tipo di contenuto |
Inserire l'intestazione del tipo di contenuto da impostare, ad esempio application/json . Specifica il formato previsto da inviare al corpo della richiesta. |
Schema di uscita |
Per consentire ai comandi successivi della catena di accedere alle proprietà di output di questo comando, inserire un payload di esempio per ogni output JSON. |
Uscite
Uscita |
Tipo di uscita |
Intestazioni di risposta |
JSON |
Risposta |
File |
Codice di risposta |
Intero |
Codici di uscita
Codice |
Tipo |
Dettaglio |
0 |
Il successo |
Il successo |
2 |
Errore |
Richiesta fallita; codice di risposta non-200 |
4 |
Errore |
Certificato non trovato |
5 |
Errore |
Intestazioni della richiesta non valide |
Posta
Per posizionare una risorsa, utilizzare il comando Post. Questo comando effettua una richiesta HTTP POST
, come https://postman-echo.com/post
.
Proprietà
Proprietà |
Dettaglio |
Nome utente |
Se è richiesta l'autenticazione di base, inserire il nome utente. |
Password |
Se è richiesta l'autenticazione di base, inserire la password. |
Certificato CA |
Inserire il certificato CA da utilizzare per la richiesta (opzionale). |
Certificato |
Inserire il certificato da inviare con la richiesta (opzionale). Se previsto, inserire anche Chiave privata del certificato. |
Chiave privata del certificato |
Inserire la chiave privata del certificato , se fornita. |
Mostra la risposta |
Per mostrare il corpo della risposta API nell'output, selezionare questa casella. |
URL |
Inserire l'URL utilizzato per la richiesta, ad esempio https://postman-echo.com/post . |
Tipo di contenuto |
Immettere l'intestazione del tipo di contenuto da impostare. Specifica il formato previsto da inviare al corpo della richiesta. Nota: Per i dati in più parti, aggiungere Valori del modulo per generare il corpo. |
File corpo |
Inserire il file che contiene l'oggetto JSON o i parametri della richiesta da inviare nel corpo della richiesta. Se lo si include, lasciare vuoto Body text. |
Testo del corpo |
Inserire il testo da inviare nel corpo della richiesta. Se lo si include, lasciare vuoto il file Body. |
Intestazioni |
Inserire eventuali intestazioni aggiuntive da aggiungere alla richiesta. |
Valori della forma |
Per generare il corpo per i dati in più parti, aggiungere i valori del modulo da includere nella richiesta e inserire il nome e il valore per ciascuno. Se si aggiungono valori di modulo, lasciare vuoto Tipo di contenuto. |
Schema di uscita |
Per consentire ai comandi successivi della catena di accedere alle proprietà di output di questo comando, inserire un payload di esempio per ogni output JSON. |
Uscite
Uscita |
Tipo di uscita |
Intestazioni di risposta |
JSON |
Risposta |
File |
Codice di risposta |
Intero |
Codici di uscita
Codice |
Tipo |
Dettaglio |
0 |
Il successo |
Il successo |
2 |
Errore |
Richiesta fallita; codice di risposta non-200 |
4 |
Errore |
Certificato non trovato |
5 |
Errore |
Intestazioni della richiesta non valide |
Mettere
Per modificare o aggiornare una risorsa, utilizzare il comando Put. Questo comando effettua una richiesta HTTP PUT
, come https://postman-echo.com/put
.
Proprietà
Proprietà |
Dettaglio |
Nome utente |
Se è richiesta l'autenticazione di base, inserire il nome utente. |
Password |
Se è richiesta l'autenticazione di base, inserire la password. |
Certificato CA |
Inserire il certificato CA da utilizzare per la richiesta (opzionale). |
Certificato |
Inserire il certificato da inviare con la richiesta (opzionale). Se previsto, inserire anche Chiave privata del certificato. |
Chiave privata del certificato |
Inserire la chiave privata del certificato , se fornita. |
Mostra la risposta |
Per mostrare il corpo della risposta API nell'output, selezionare questa casella. |
URL |
Inserire l'URL utilizzato per la richiesta. |
Tipo di contenuto |
Immettere l'intestazione del tipo di contenuto da impostare. Specifica il formato previsto da inviare al corpo della richiesta. Nota: Per i dati in più parti, aggiungere Valori del modulo per generare il corpo. |
File corpo |
Inserire il file che contiene l'oggetto JSON o i parametri della richiesta da inviare nel corpo della richiesta. Se lo si include, lasciare vuoto Body text. |
Testo del corpo |
Inserire il testo da inviare nel corpo della richiesta. Se lo si include, lasciare vuoto il file Body. |
Intestazioni |
Inserire eventuali intestazioni aggiuntive da aggiungere alla richiesta. |
Valori della forma |
Per generare il corpo per i dati in più parti, aggiungere i valori del modulo da includere nella richiesta e inserire il nome e il valore per ciascuno. Se si aggiungono valori di modulo, lasciare vuoto Tipo di contenuto. |
Schema di uscita |
Per consentire ai comandi successivi della catena di accedere alle proprietà di output di questo comando, inserire un payload di esempio per ogni output JSON. |
Uscite
Uscita |
Tipo di uscita |
Intestazioni di risposta |
JSON |
Risposta |
File |
Codice di risposta |
Intero |
Codici di uscita
Codice |
Tipo |
Dettaglio |
0 |
Il successo |
Il successo |
2 |
Errore |
Richiesta fallita; codice di risposta non-200 |
4 |
Errore |
Certificato non trovato |
5 |
Errore |
Intestazioni della richiesta non valide |