|
Klasyczne typy plików nie są już dostępne od stycznia 2021 r. Możesz przenieść swoje klasyczne pliki lub pobrać plik PDF. Dowiedz się więcej

Centrum wsparcia Workiva

Polecenia żądania HTTP

Polecenia żądania HTTP

  • Ostatnia aktualizacja

Połączenie żądań HTTP wykonuje te polecenia, aby realizować typowe żądania protokołu HyperText Transfer Protocol (HTTP) do danego adresu URL w celu łączenia się i automatyzowania obsługiwanych rozwiązań za pośrednictwem odpowiednich łączników.

Aby zobaczyć, jak zbudowane jest żądanie HTTP, zobacz naszą listę przykładów łączników HTTP.

Uwaga: Mimo że jest to oznaczone jako żądanie HTTP, protokół HTTPS (bezpieczny protokół HTTP) jest obsługiwany (i zalecany).

Wymagania

  • Chociaż połączenie nie ma żadnych cech specyficznych dla protokołu OData, możesz dodać dowolne niezbędne komponenty żądania za pomocą parametrów Nagłówki lub Ciąg zapytania.
  • Aby włączyć wzajemne uwierzytelnianie TLS (mTLS), podaj parę kluczy publicznego i prywatnego oraz opcjonalnie certyfikat CA. Aby użyć kluczy publicznego i prywatnego, prześlij je jako zasoby obszaru roboczego, a następnie wybierz je odpowiednio dla parametrów Certyfikat i Klucz prywatny certyfikatupolecenia.
  • Plik zawierający klucz prywatny nie może być zaszyfrowany. Załadowanie zaszyfrowanego pliku jako klucza prywatnego spowoduje wystąpienie błędu.

Aby włączyć te polecenia, administrator IT najpierw tworzy łącznik żądania HTTP.

Usuń

Aby usunąć zasób, użyj polecenia Delete. To polecenie wysyła żądanie HTTP DELETE, takie jak http://postman-echo.com/delete.

Właściwości

Właściwość Szczegół
Nazwa użytkownika Jeśli wymagane jest uwierzytelnianie podstawowe, wprowadź nazwę użytkownika.
Hasło Jeśli wymagane jest uwierzytelnianie podstawowe, wprowadź hasło.
Certyfikat CA Wprowadź certyfikat Urzędu Certyfikacji (CA), który ma zostać użyty podczas składania żądania (opcjonalnie).
Certyfikat Wprowadź certyfikat, który chcesz wysłać wraz z żądaniem (opcjonalnie). Jeśli podano, wpisz również Klucz prywatny certyfikatu.
Klucz prywatny certyfikatu Wprowadź klucz prywatny dla Certyfikatu, jeśli został podany.
Pokaż odpowiedź Aby wyświetlić treść odpowiedzi API w wynikach, zaznacz to pole.
Adres URL Wprowadź adres URL użyty w żądaniu, na przykład http://postman-echo.com/delete.
Typ zawartości Wprowadź nagłówek typu zawartości, który chcesz ustawić. Określa oczekiwany format, który należy wysłać do treści żądania.
Plik ciała Wprowadź plik zawierający obiekt JSON lub parametry żądania, które mają zostać wysłane w treści żądania. Jeśli chcesz to uwzględnić, pozostaw pole Tekst główny puste.
Tekst główny Wprowadź tekst, który chcesz wysłać w treści żądania. Jeśli chcesz to uwzględnić, pozostaw pole Plik treści puste.
Nagłówki Wprowadź wszelkie 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ół
0 Powodzenie Powodzenie
2 Błąd Żądanie nie powiodło się; kod odpowiedzi inny niż 200
4 Błąd Nie znaleziono certyfikatu
5 Błąd Nieprawidłowe nagłówki żądania

Dostawać

Aby pobrać zasób, użyj polecenia Get. To polecenie tworzy żądanie HTTP GET, takie jak https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Uwaga: To polecenie zawiera spację do wprowadzenia parametrów zapytania — parametry nie powinny być uwzględniane w samym adresie URL. Jeśli parametry zostaną wprowadzone zarówno w polu adresu URL, jak i w polu „Ciąg zapytania”, zostaną one usunięte z adresu URL.

Właściwości

Właściwość Szczegół
Nazwa użytkownika Jeśli wymagane jest uwierzytelnianie podstawowe, wprowadź nazwę użytkownika.
Hasło Jeśli wymagane jest uwierzytelnianie podstawowe, wprowadź hasło.
Certyfikat CA Wprowadź certyfikat CA, który chcesz użyć podczas składania wniosku (opcjonalnie).
Certyfikat Wprowadź certyfikat, który chcesz wysłać wraz z żądaniem (opcjonalnie). Jeśli podano, wpisz również Klucz prywatny certyfikatu.
Klucz prywatny certyfikatu Wprowadź klucz prywatny dla Certyfikatu, jeśli został podany.
Pokaż odpowiedź Aby wyświetlić treść odpowiedzi API w wynikach, zaznacz to pole.
Adres URL Wprowadź adres URL użyty w żądaniu, na przykład 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ź wszelkie dodatkowe nagłówki, które chcesz dodać do żądania.
Typ zawartości Wprowadź nagłówek typu zawartości, który chcesz ustawić, np. application/json. Określa oczekiwany format, który należy wysłać 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 wyniku 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ół
0 Powodzenie Powodzenie
2 Błąd Żądanie nie powiodło się; kod odpowiedzi inny niż 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. To polecenie tworzy żądanie HTTP POST, takie jak https://postman-echo.com/post.

Właściwości

Właściwość Szczegół
Nazwa użytkownika Jeśli wymagane jest uwierzytelnianie podstawowe, wprowadź nazwę użytkownika.
Hasło Jeśli wymagane jest uwierzytelnianie podstawowe, wprowadź hasło.
Certyfikat CA Wprowadź certyfikat CA, który chcesz użyć podczas składania wniosku (opcjonalnie).
Certyfikat Wprowadź certyfikat, który chcesz wysłać wraz z żądaniem (opcjonalnie). Jeśli podano, wpisz również Klucz prywatny certyfikatu.
Klucz prywatny certyfikatu Wprowadź klucz prywatny dla Certyfikatu, jeśli został podany.
Pokaż odpowiedź Aby wyświetlić treść odpowiedzi API w wynikach, zaznacz to pole.
Adres URL Wprowadź adres URL użyty w żądaniu, na przykład https://postman-echo.com/post.
Typ zawartości

Wprowadź nagłówek typu zawartości, który chcesz ustawić. Określa oczekiwany format, który należy wysłać do treści żądania.

Uwaga: W przypadku danych składających się z wielu części, zamiast tego dodaj Wartości formularza, aby wygenerować treść.
Plik ciała Wprowadź plik zawierający obiekt JSON lub parametry żądania, które mają zostać wysłane w treści żądania. Jeśli chcesz to uwzględnić, pozostaw pole Tekst główny puste.
Tekst główny

Wprowadź tekst, który chcesz wysłać w treści żądania. Jeśli chcesz to uwzględnić, pozostaw pole Plik treści puste.
Wskazówka: jeśli występują parametry wielokrotnego wyboru, użyj następującego wzorca:

{ "queryId": "TWÓJ_ID_ZAPYTANIA", "parametry": { "twojaNazwaParametru": ["wartość1", "wartość2"] } }
Nagłówki Wprowadź wszelkie dodatkowe nagłówki, które chcesz dodać do żądania.
Wartości formularza Aby wygenerować treść dla danych składających się z wielu części, dodaj wartości formularza, które mają zostać uwzględnione w żądaniu, i wprowadź nazwę i wartość dla każdej z nich. Jeśli dodajesz wartości formularza, pozostaw pole Typ zawartości puste.
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 wyniku 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ół
0 Powodzenie Powodzenie
2 Błąd Żądanie nie powiodło się; kod odpowiedzi inny niż 200
4 Błąd Nie znaleziono certyfikatu
5 Błąd Nieprawidłowe nagłówki żądania

Umieścić

Aby zmienić lub zaktualizować zasób, użyj polecenia Put. To polecenie tworzy żądanie HTTP PUT, takie jak https://postman-echo.com/put.

Właściwości

Właściwość Szczegół
Nazwa użytkownika Jeśli wymagane jest uwierzytelnianie podstawowe, wprowadź nazwę użytkownika.
Hasło Jeśli wymagane jest uwierzytelnianie podstawowe, wprowadź hasło.
Certyfikat CA Wprowadź certyfikat CA, który chcesz użyć podczas składania wniosku (opcjonalnie).
Certyfikat Wprowadź certyfikat, który chcesz wysłać wraz z żądaniem (opcjonalnie). Jeśli podano, wpisz również Klucz prywatny certyfikatu.
Klucz prywatny certyfikatu Wprowadź klucz prywatny dla Certyfikatu, jeśli został podany.
Pokaż odpowiedź Aby wyświetlić treść odpowiedzi API w wynikach, zaznacz to pole.
Adres URL Wprowadź adres URL użyty w żądaniu.
Typ zawartości

Wprowadź nagłówek typu zawartości, który chcesz ustawić. Określa oczekiwany format, który należy wysłać do treści żądania.

Uwaga: W przypadku danych składających się z wielu części, zamiast tego dodaj Wartości formularza, aby wygenerować treść.
Plik ciała Wprowadź plik zawierający obiekt JSON lub parametry żądania, które mają zostać wysłane w treści żądania. Jeśli chcesz to uwzględnić, pozostaw pole Tekst główny puste.
Tekst główny Wprowadź tekst, który chcesz wysłać w treści żądania. Jeśli chcesz to uwzględnić, pozostaw pole Plik treści puste.
Nagłówki Wprowadź wszelkie dodatkowe nagłówki, które chcesz dodać do żądania.
Wartości formularza Aby wygenerować treść dla danych składających się z wielu części, dodaj wartości formularza, które mają zostać uwzględnione w żądaniu, i wprowadź nazwę i wartość dla każdej z nich. Jeśli dodajesz wartości formularza, pozostaw pole Typ zawartości puste.
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 wyniku 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ół
0 Powodzenie Powodzenie
2 Błąd Żądanie nie powiodło się; kod odpowiedzi inny niż 200
4 Błąd Nie znaleziono certyfikatu
5 Błąd Nieprawidłowe nagłówki żądania
Czy ten artykuł był pomocny?
Liczba użytkowników, którzy uważają ten artykuł za przydatny: 2 z 8
Połączenie żądań HTTP wykonuje te polecenia, aby realizować typowe żądania protokołu HyperText Transfer Protocol (HTT...