Połączenie HTTP Requests wykonuje te polecenia, aby wykonać typowe żądania HyperText Transfer Protocol (HTTP) do danego adresu URL w celu połączenia i zautomatyzowania obsługiwanych rozwiązań za pośrednictwem odpowiednich łączników.
Aby zobaczyć strukturę żądania HTTP, zapoznaj się z naszą przykładową listą konektorów HTTP .
Wymagania
- Chociaż połączenie nie ma funkcji specyficznych dla OData, możesz dodać wszelkie niezbędne komponenty żądania za pomocą parametrów Headers lub Query string .
- Aby włączyć wzajemne uwierzytelnianie TLS (mTLS), podaj parę kluczy publiczny/prywatny i, opcjonalnie, certyfikat CA. Aby użyć klucza publicznego i prywatnego, prześlij je na stronę jako zasoby obszaru roboczego, a następnie wybierz je odpowiednio dla parametrów polecenia Certyfikat i Klucz prywatny certyfikatu .
Aby włączyć te polecenia, administrator IT najpierw tworzy konektor żądań HTTP.
Usuń
Aby usunąć zasób, użyj polecenia Delete . Polecenie to wykonuje żądanie HTTP DELETE
, takie jak http://postman-echo.com/delete
.
Właściwości
Właściwość |
Szczegóły |
Nazwa użytkownika |
Jeśli wymagane jest podstawowe uwierzytelnianie, wprowadź nazwę użytkownika. |
Hasło |
Jeśli wymagane jest podstawowe uwierzytelnianie, wprowadź hasło. |
Certyfikat CA |
Wprowadź certyfikat urzędu certyfikacji (CA), który ma zostać użyty podczas wysyłania żądania (opcjonalnie). |
Certyfikat |
Wprowadź certyfikat do wysłania wraz z żądaniem (opcjonalnie). Jeśli podano, wprowadź również klucz prywatny certyfikatu . |
Klucz prywatny certyfikatu |
Wprowadź klucz prywatny dla certyfikatu , jeśli został dostarczony. |
Pokaż odpowiedź |
Aby wyświetlić treść odpowiedzi API na wyjściu, zaznacz to pole. |
Adres URL |
Wprowadź adres URL użyty dla żądania, np. http://postman-echo.com/delete . |
Typ zawartości |
Wprowadź nagłówek typu zawartości do ustawienia. Określa oczekiwany format wysyłany do treści żądania. |
Plik nadwozia |
Wprowadź plik zawierający obiekt JSON lub parametry żądania do wysłania w treści żądania. Jeśli ją dołączysz, pozostaw Body text puste. |
Treść |
Wprowadź tekst do wysłania w treści żądania. Jeśli to uwzględnisz, pozostaw plik Body pusty. |
Nagłówki |
Wprowadź dodatkowe nagłówki, które chcesz dodać do żądania. |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Nagłówki odpowiedzi |
JSON |
Odpowiedź |
Plik |
Kod odpowiedzi |
Liczba całkowita |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
2 |
Błąd |
Żądanie nie powiodło się; kod odpowiedzi non-200 |
4 |
Błąd |
Nie znaleziono certyfikatu |
5 |
Błąd |
Nieprawidłowe nagłówki żądania |
Pobierz
Aby pobrać zasób, użyj polecenia Get . To polecenie wysyła żądanie HTTP GET
, takie jak https://postman-echo.com/get?foo1=bar1&foo2=bar2
.
Uwaga: To polecenie zawiera spację do wprowadzania parametrów zapytania - parametry nie powinny być zawarte w samym adresie URL. Jeśli parametry zostaną wprowadzone zarówno w adresie URL, jak i w polu "Ciąg zapytania", zostaną one usunięte z adresu URL.
Właściwości
Właściwość |
Szczegóły |
Nazwa użytkownika |
Jeśli wymagane jest podstawowe uwierzytelnianie, wprowadź nazwę użytkownika. |
Hasło |
Jeśli wymagane jest podstawowe uwierzytelnianie, wprowadź hasło. |
Certyfikat CA |
Wprowadź certyfikat CA, który ma zostać użyty podczas wysyłania żądania (opcjonalnie). |
Certyfikat |
Wprowadź certyfikat do wysłania wraz z żądaniem (opcjonalnie). Jeśli podano, wprowadź również klucz prywatny certyfikatu . |
Klucz prywatny certyfikatu |
Wprowadź klucz prywatny dla certyfikatu , jeśli został dostarczony. |
Pokaż odpowiedź |
Aby wyświetlić treść odpowiedzi API na wyjściu, zaznacz to pole. |
Adres URL |
Wprowadź adres URL użyty dla żądania, np. https://postman-echo.com/get . |
Ciąg zapytania |
Wprowadź ciąg zapytania, który ma zostać dołączony do żądania, np. foo1=bar1&foo2=bar2 . Uwaga: Ciąg zapytania musi być zakodowany. |
Nagłówki |
Wprowadź dodatkowe nagłówki, które chcesz dodać do żądania. |
Typ zawartości |
Wprowadź nagłówek typu zawartości do ustawienia, np. application/json . Określa oczekiwany format wysyłany do treści żądania. |
Schemat wyjściowy |
Aby umożliwić późniejszym poleceniom w łańcuchu dostęp do właściwości wyjściowych tego polecenia, wprowadź przykładowy ładunek dla każdego wyjścia JSON. |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Nagłówki odpowiedzi |
JSON |
Odpowiedź |
Plik |
Kod odpowiedzi |
Liczba całkowita |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
2 |
Błąd |
Żądanie nie powiodło się; kod odpowiedzi non-200 |
4 |
Błąd |
Nie znaleziono certyfikatu |
5 |
Błąd |
Nieprawidłowe nagłówki żądania |
Opublikuj
Aby umieścić zasób, użyj polecenia Post . Polecenie to wykonuje żądanie HTTP POST
, takie jak https://postman-echo.com/post
.
Właściwości
Właściwość |
Szczegóły |
Nazwa użytkownika |
Jeśli wymagane jest podstawowe uwierzytelnianie, wprowadź nazwę użytkownika. |
Hasło |
Jeśli wymagane jest podstawowe uwierzytelnianie, wprowadź hasło. |
Certyfikat CA |
Wprowadź certyfikat CA, który ma zostać użyty podczas wysyłania żądania (opcjonalnie). |
Certyfikat |
Wprowadź certyfikat do wysłania wraz z żądaniem (opcjonalnie). Jeśli podano, wprowadź również klucz prywatny certyfikatu . |
Klucz prywatny certyfikatu |
Wprowadź klucz prywatny dla certyfikatu , jeśli został dostarczony. |
Pokaż odpowiedź |
Aby wyświetlić treść odpowiedzi API na wyjściu, zaznacz to pole. |
Adres URL |
Wprowadź adres URL użyty dla żądania, np. https://postman-echo.com/post . |
Typ zawartości |
Wprowadź nagłówek typu zawartości do ustawienia. Określa oczekiwany format wysyłany do treści żądania. Uwaga: W przypadku danych wieloczęściowych dodaj zamiast tego wartości formularza , aby wygenerować treść. |
Plik nadwozia |
Wprowadź plik zawierający obiekt JSON lub parametry żądania do wysłania w treści żądania. Jeśli ją dołączysz, pozostaw Body text puste. |
Treść |
Wprowadź tekst do wysłania w treści żądania. Jeśli to uwzględnisz, pozostaw plik Body pusty. |
Nagłówki |
Wprowadź dodatkowe nagłówki, które chcesz dodać do żądania. |
Wartości formularza |
Aby wygenerować treść dla danych wieloczęściowych, dodaj wartości formularza do uwzględnienia w żądaniu, a następnie wprowadź nazwę i wartość dla każdej z nich. Jeśli dodasz wartości formularza, pozostaw stronę Content type pustą. |
Schemat wyjściowy |
Aby umożliwić późniejszym poleceniom w łańcuchu dostęp do właściwości wyjściowych tego polecenia, wprowadź przykładowy ładunek dla każdego wyjścia JSON. |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Nagłówki odpowiedzi |
JSON |
Odpowiedź |
Plik |
Kod odpowiedzi |
Liczba całkowita |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
2 |
Błąd |
Żądanie nie powiodło się; kod odpowiedzi non-200 |
4 |
Błąd |
Nie znaleziono certyfikatu |
5 |
Błąd |
Nieprawidłowe nagłówki żądania |
Umieść
Aby zmienić lub zaktualizować zasób, użyj polecenia Put . Polecenie to wykonuje żądanie HTTP PUT
, takie jak https://postman-echo.com/put
.
Właściwości
Właściwość |
Szczegóły |
Nazwa użytkownika |
Jeśli wymagane jest podstawowe uwierzytelnianie, wprowadź nazwę użytkownika. |
Hasło |
Jeśli wymagane jest podstawowe uwierzytelnianie, wprowadź hasło. |
Certyfikat CA |
Wprowadź certyfikat CA, który ma zostać użyty podczas wysyłania żądania (opcjonalnie). |
Certyfikat |
Wprowadź certyfikat do wysłania wraz z żądaniem (opcjonalnie). Jeśli podano, wprowadź również klucz prywatny certyfikatu . |
Klucz prywatny certyfikatu |
Wprowadź klucz prywatny dla certyfikatu , jeśli został dostarczony. |
Pokaż odpowiedź |
Aby wyświetlić treść odpowiedzi API na wyjściu, zaznacz to pole. |
Adres URL |
Wprowadź adres URL używany dla żądania. |
Typ zawartości |
Wprowadź nagłówek typu zawartości do ustawienia. Określa oczekiwany format wysyłany do treści żądania. Uwaga: W przypadku danych wieloczęściowych dodaj zamiast tego wartości formularza , aby wygenerować treść. |
Plik nadwozia |
Wprowadź plik zawierający obiekt JSON lub parametry żądania do wysłania w treści żądania. Jeśli ją dołączysz, pozostaw Body text puste. |
Treść |
Wprowadź tekst do wysłania w treści żądania. Jeśli to uwzględnisz, pozostaw plik Body pusty. |
Nagłówki |
Wprowadź dodatkowe nagłówki, które chcesz dodać do żądania. |
Wartości formularza |
Aby wygenerować treść dla danych wieloczęściowych, dodaj wartości formularza do uwzględnienia w żądaniu i wprowadź nazwę i wartość dla każdej z nich. Jeśli dodajesz wartości formularza, pozostaw stronę Content type pustą. |
Schemat wyjściowy |
Aby umożliwić późniejszym poleceniom w łańcuchu dostęp do właściwości wyjściowych tego polecenia, wprowadź przykładowy ładunek dla każdego wyjścia JSON. |
Dane wyjściowe
Dane wyjściowe |
Typ wyjścia |
Nagłówki odpowiedzi |
JSON |
Odpowiedź |
Plik |
Kod odpowiedzi |
Liczba całkowita |
Kody wyjścia
Kod |
Typ |
Szczegóły |
0 |
Powodzenie |
Powodzenie |
2 |
Błąd |
Żądanie nie powiodło się; kod odpowiedzi non-200 |
4 |
Błąd |
Nie znaleziono certyfikatu |
5 |
Błąd |
Nieprawidłowe nagłówki żądania |