|
Klassiska filtyper är inte längre tillgängliga för användning från och med januari 2021. Du kan överföra dina klassiska filer eller ladda ner en PDF. Läs mer

Workiva supportcenter

Kommandon för HTTP-begäran

Kommandon för HTTP-begäran

  • Senast uppdaterad

En HTTP Requests-anslutning utför dessa kommandon för att utföra vanliga HTTP-förfrågningar (HyperText Transfer Protocol) till en viss URL för att ansluta och automatisera lösningar som stöds via deras respektive anslutningar.

För att se hur en HTTP-begäran är strukturerad, se vår HTTP Connector exempellista.

Obs: Även om detta är märkt som HTTP-begäran, stöds (och rekommenderas) HTTPS (Secure HTTP).

Krav

  • Anslutningen har inga OData-specifika funktioner, men du kan lägga till alla nödvändiga komponenter i begäran via rubriker eller frågesträng parametrar.
  • För att aktivera ömsesidig TLS-autentisering (mTLS), ange ett offentligt/privat nyckelpar och, eventuellt, ett CA-certifikat. Om du vill använda de offentliga och privata nycklarna ska du ladda upp dem som resurser på arbetsytan och sedan välja dem för kommandots parametrar Certifikat respektive Certifikat privat nyckel.
  • Filen som innehåller den privata nyckeln får inte vara krypterad. Att ladda en krypterad fil som en privat nyckel kommer att resultera i ett fel.

För att aktivera dessa kommandon skapar en IT-administratör först en HTTP Request Connector.

Ta bort

Om du vill ta bort en resurs använder du kommandot Delete. Detta kommando gör en HTTP DELETE -begäran, t.ex. http://postman-echo.com/delete.

Fastigheter

Egenskap Detalj
Användarnamn Om grundläggande autentisering krävs anger du användarnamnet.
Lösenord Om grundläggande autentisering krävs anger du lösenordet.
CA-certifikat Ange det certifikat från certifikatutfärdaren (CA) som ska användas när begäran görs (valfritt).
Certifikat Ange det certifikat som ska skickas med begäran (valfritt). Ange även Certifikatets privata nyckel om sådan finns.
Certifikatets privata nyckel Ange den privata nyckeln för Certifikat, om sådan finns.
Visa svar Markera den här rutan om du vill visa API-svarstexten i utdata.
URL Ange den URL som används för begäran, t.ex. http://postman-echo.com/delete.
Typ av innehåll Ange vilken rubrik för innehållstyp som ska anges. Här anges det förväntade format som ska skickas till begäran.
Arkivering av kropp Ange den arkivering som innehåller JSON-objektet eller parametrarna för begäran som ska skickas i begärans kropp. Om du inkluderar detta, lämna Body text tom.
Text i brödtext Ange den text som ska skickas i meddelandetexten. Om du inkluderar detta, lämna Body arkivering tom.
Rubriker Ange eventuella ytterligare rubriker som ska läggas till i begäran.

Utdata

Utdata Typ av utgång
Rubriker för svar JSON
Svar Fil
Svarskod Heltal

Utgångskoder

Kod Typ Detalj
0 Lyckades Lyckades
2 Fel Begäran gick inte igenom
4 Fel Certifikatet hittades inte
5 Fel Ogiltiga rubriker för begäran

Hämta

Om du vill hämta en resurs använder du kommandot Get. Detta kommando gör en HTTP GET -begäran, t.ex. https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Obs: Det här kommandot innehåller ett mellanslag för att ange frågeparametrar - parametrarna ska inte ingå i själva URL:en. Om parametrar anges både i URL:en och i fältet "Query string" kommer de att tas bort från URL:en.

Fastigheter

Egenskap Detalj
Användarnamn Om grundläggande autentisering krävs anger du användarnamnet.
Lösenord Om grundläggande autentisering krävs anger du lösenordet.
CA-certifikat Ange det CA-certifikat som ska användas när begäran görs (valfritt).
Certifikat Ange det certifikat som ska skickas med begäran (valfritt). Ange även Certifikatets privata nyckel om sådan finns.
Certifikatets privata nyckel Ange den privata nyckeln för Certifikat, om sådan finns.
Visa svar Markera den här rutan om du vill visa API-svarstexten i utdata.
URL Ange den URL som används för begäran, t.ex. https://postman-echo.com/get.
Frågesträng

Ange den frågesträng som ska läggas till begäran, t.ex. foo1=bar1&foo2=bar2.

Obs: Frågesträngen måste vara kodad.
Rubriker Ange eventuella ytterligare rubriker som ska läggas till i begäran.
Typ av innehåll Ange den rubrik för innehållstyp som ska anges, t.ex. application/json. Här anges det förväntade format som ska skickas till begäran.
Utmatningsschema För att göra det möjligt för senare kommandon i kedjan att få åtkomst till detta kommandos utdataegenskaper, ange ett prov på nyttolasten för varje JSON-utdata. 

Utdata

Utdata Typ av utgång
Rubriker för svar JSON
Svar Fil
Svarskod Heltal

Utgångskoder

Kod Typ Detalj
0 Lyckades Lyckades
2 Fel Begäran gick inte igenom
4 Fel Certifikatet hittades inte
5 Fel Ogiltiga rubriker för begäran

Post

Om du vill placera en resurs använder du kommandot Post. Detta kommando gör en HTTP POST -begäran, t.ex. https://postman-echo.com/post.

Fastigheter

Egenskap Detalj
Användarnamn Om grundläggande autentisering krävs anger du användarnamnet.
Lösenord Om grundläggande autentisering krävs anger du lösenordet.
CA-certifikat Ange det CA-certifikat som ska användas när begäran görs (valfritt).
Certifikat Ange det certifikat som ska skickas med begäran (valfritt). Ange även Certifikatets privata nyckel om sådan finns.
Certifikatets privata nyckel Ange den privata nyckeln för Certifikat, om sådan finns.
Visa svar Markera den här rutan om du vill visa API-svarstexten i utdata.
URL Ange den URL som används för begäran, t.ex. https://postman-echo.com/post.
Typ av innehåll

Ange vilken rubrik för innehållstyp som ska anges. Här anges det förväntade format som ska skickas till begäran.

Obs: För data i flera delar, lägg till Formulärvärden istället för att generera kroppen.
Arkivering av kropp Ange den arkivering som innehåller JSON-objektet eller parametrarna för begäran som ska skickas i begärans kropp. Om du inkluderar detta, lämna Body text tom.
Text i brödtext

Ange den text som ska skickas i meddelandetexten. Om du inkluderar detta, lämna Body arkivering tom.
Tips: Om det finns flervalsparametrar, använd följande mönster:

{ "queryId": "YOUR_QUERY_ID", "parametrar": { "yourParamName": ["value1", "value2"] } }
Rubriker Ange eventuella ytterligare rubriker som ska läggas till i begäran.
Formulärvärden Om du vill skapa en body för data som består av flera delar lägger du till de formulärvärden som ska ingå i begäran och anger namn och värde för varje värde. Om du lägger till formulärvärden ska du lämna Content type tom.
Utmatningsschema För att göra det möjligt för senare kommandon i kedjan att få åtkomst till detta kommandos utdataegenskaper, ange ett prov på nyttolasten för varje JSON-utdata. 

Utdata

Utdata Typ av utgång
Rubriker för svar JSON
Svar Fil
Svarskod Heltal

Utgångskoder

Kod Typ Detalj
0 Lyckades Lyckades
2 Fel Begäran gick inte igenom
4 Fel Certifikatet hittades inte
5 Fel Ogiltiga rubriker för begäran

Sätt

Om du vill ändra eller uppdatera en resurs använder du kommandot Put. Detta kommando gör en HTTP PUT -begäran, t.ex. https://postman-echo.com/put.

Fastigheter

Egenskap Detalj
Användarnamn Om grundläggande autentisering krävs anger du användarnamnet.
Lösenord Om grundläggande autentisering krävs anger du lösenordet.
CA-certifikat Ange det CA-certifikat som ska användas när begäran görs (valfritt).
Certifikat Ange det certifikat som ska skickas med begäran (valfritt). Ange även Certifikatets privata nyckel om sådan finns.
Certifikatets privata nyckel Ange den privata nyckeln för Certifikat, om sådan finns.
Visa svar Markera den här rutan om du vill visa API-svarstexten i utdata.
URL Ange den URL som används för begäran.
Typ av innehåll

Ange vilken rubrik för innehållstyp som ska anges. Här anges det förväntade format som ska skickas till begäran.

Obs: För data i flera delar, lägg till Formulärvärden istället för att generera kroppen.
Arkivering av kropp Ange den arkivering som innehåller JSON-objektet eller parametrarna för begäran som ska skickas i begärans kropp. Om du inkluderar detta, lämna Body text tom.
Text i brödtext Ange den text som ska skickas i meddelandetexten. Om du inkluderar detta, lämna Body arkivering tom.
Rubriker Ange eventuella ytterligare rubriker som ska läggas till i begäran.
Formulärvärden Om du vill skapa en body för data som består av flera delar lägger du till de formulärvärden som ska ingå i begäran och anger namn och värde för varje värde. Om du lägger till formulärvärden ska du lämna Content type tom.
Utmatningsschema För att göra det möjligt för senare kommandon i kedjan att få åtkomst till detta kommandos utdataegenskaper, ange ett prov på nyttolasten för varje JSON-utdata.

Utdata

Utdata Typ av utgång
Rubriker för svar JSON
Svar Fil
Svarskod Heltal

Utgångskoder

Kod Typ Detalj
0 Lyckades Lyckades
2 Fel Begäran gick inte igenom
4 Fel Certifikatet hittades inte
5 Fel Ogiltiga rubriker för begäran
En HTTP Requests-anslutning utför dessa kommandon för att utföra vanliga HTTP-förfrågningar (HyperText Transfer Proto...