|
Klassiske filtyper er ikke lenger tilgjengelige for bruk fra og med januar 2021. Du kan overføre klassiske filer eller laste ned en PDF-fil. Finn ut mer

Workiva kundestøttesenter

HTTP-forespørselskommandoer

HTTP-forespørselskommandoer

  • Sist oppdatert

En HTTP-forespørselstilkobling utfører disse kommandoene for å utføre vanlige HTTP-forespørsler (HyperText Transfer Protocol) til en gitt URL for å koble til og automatisere støttede løsninger gjennom deres respektive koblinger.

For å se hvordan en HTTP-forespørsel er strukturert, se vår HTTP Connector-eksempelliste.

Merk: Selv om dette er merket som HTTP-forespørsel, støttes (og anbefales) HTTPS (sikker HTTP).

Krav

  • Selv om tilkoblingen ikke har noen OData-spesifikke funksjoner, kan du legge til nødvendige komponenter i forespørselen via parameterne Headers eller Query string.
  • For å aktivere gjensidig TLS (mTLS)-autentisering, må du oppgi et offentlig/privat nøkkelpar og eventuelt et CA-sertifikat. For å bruke de offentlige og private nøklene, last dem opp som arbeidsområderessurser, og velg dem deretter for kommandoens parametere Sertifikat og Privat nøkkel for sertifikat, henholdsvis.
  • Filen som inneholder den private nøkkelen må ikke være kryptert. Lasting av en kryptert fil som en privat nøkkel vil føre til en feil.

For å aktivere disse kommandoene, oppretter en IT-administrator først en HTTP-forespørselskobling .

Slett

For å fjerne en ressurs, bruk kommandoen Slett. Denne kommandoen foretar en HTTP DELETE forespørsel, for eksempel http://postman-echo.com/delete.

Egenskaper

Egenskap Detalj
Brukernavn Hvis grunnleggende autentisering er nødvendig, skriv inn brukernavnet.
Passord Hvis grunnleggende autentisering er nødvendig, skriv inn passordet.
CA-sertifikat Angi sertifikatutstederens (CA) sertifikat som skal brukes når du sender forespørselen (valgfritt).
Sertifikat Skriv inn sertifikatet som skal sendes med forespørselen (valgfritt). Hvis oppgitt, skriv også inn Sertifikatets private nøkkel.
Privat nøkkel for sertifikat Skriv inn den private nøkkelen for Sertifikat, hvis oppgitt.
Vis svar For å vise API-svarinnholdet i utdataene, merk av i denne boksen.
URL Skriv inn URL-en som ble brukt for forespørselen, for eksempel http://postman-echo.com/delete.
Innholdstype Skriv inn innholdstypehodet som skal angis. Dette angir det forventede formatet som skal sendes til forespørselsinnholdet.
Kroppsfil Skriv inn filen som inneholder JSON-objektet eller forespørselsparameterne som skal sendes i forespørselsteksten. Hvis du inkluderer dette, lar du Brødtekst stå tomt.
brødtekst Skriv inn teksten som skal sendes i forespørselsteksten. Hvis du inkluderer dette, lar du Body-file stå tomt.
Topptekster Skriv inn eventuelle ekstra overskrifter som skal legges til i forespørselen.

Utganger

Utdata Utgangstype
Svaroverskrifter JSON
Svar Fil
Svarkode Heltall

Utgangskoder

Kode Type Detalj
0 Vellykket Vellykket
2 Feil Forespørsel mislyktes; ikke-200-svarkode
4 Feil Sertifikatet ble ikke funnet
5 Feil Ugyldige forespørselshoder

Bli

For å hente en ressurs, bruk en Get -kommando. Denne kommandoen foretar en HTTP GET -forespørsel, for eksempel https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Merk: Denne kommandoen inneholder et mellomrom for å angi spørreparametere – parametere skal ikke inkluderes i selve URL-en. Hvis parametere angis i både URL-en og feltet «Spørrestreng», vil de bli fjernet fra URL-en.

Egenskaper

Egenskap Detalj
Brukernavn Hvis grunnleggende autentisering er nødvendig, skriv inn brukernavnet.
Passord Hvis grunnleggende autentisering er nødvendig, skriv inn passordet.
CA-sertifikat Angi CA-sertifikatet som skal brukes når du sender forespørselen (valgfritt).
Sertifikat Skriv inn sertifikatet som skal sendes med forespørselen (valgfritt). Hvis oppgitt, skriv også inn Sertifikatets private nøkkel.
Privat nøkkel for sertifikat Skriv inn den private nøkkelen for Sertifikat, hvis oppgitt.
Vis svar For å vise API-svarinnholdet i utdataene, merk av i denne boksen.
URL Skriv inn URL-en som ble brukt for forespørselen, for eksempel https://postman-echo.com/get.
Spørrestreng

Skriv inn spørrestrengen som skal legges til forespørselen, for eksempel foo1=bar1&foo2=bar2.

Merk: Spørrestrengen må være kodet.
Topptekster Skriv inn eventuelle ekstra overskrifter som skal legges til i forespørselen.
Innholdstype Skriv inn innholdstypehodet som skal angis, for eksempel application/json. Dette angir det forventede formatet som skal sendes til forespørselsinnholdet.
Utdataskjema For å aktivere senere kommandoer i kjeden til å få tilgang til utdataegenskapene til denne kommandoen, angi en eksempelnyttelast for hver JSON-utdata. 

Utganger

Utdata Utgangstype
Svaroverskrifter JSON
Svar Fil
Svarkode Heltall

Utgangskoder

Kode Type Detalj
0 Vellykket Vellykket
2 Feil Forespørsel mislyktes; ikke-200-svarkode
4 Feil Sertifikatet ble ikke funnet
5 Feil Ugyldige forespørselshoder

Innlegg

For å plassere en ressurs, bruk en Post -kommando. Denne kommandoen foretar en HTTP POST -forespørsel, for eksempel https://postman-echo.com/post.

Egenskaper

Egenskap Detalj
Brukernavn Hvis grunnleggende autentisering er nødvendig, skriv inn brukernavnet.
Passord Hvis grunnleggende autentisering er nødvendig, skriv inn passordet.
CA-sertifikat Angi CA-sertifikatet som skal brukes når du sender forespørselen (valgfritt).
Sertifikat Skriv inn sertifikatet som skal sendes med forespørselen (valgfritt). Hvis oppgitt, skriv også inn Sertifikatets private nøkkel.
Privat nøkkel for sertifikat Skriv inn den private nøkkelen for Sertifikat, hvis oppgitt.
Vis svar For å vise API-svarinnholdet i utdataene, merk av i denne boksen.
URL Skriv inn URL-en som ble brukt for forespørselen, for eksempel https://postman-echo.com/post.
Innholdstype

Skriv inn innholdstypehodet som skal angis. Dette angir det forventede formatet som skal sendes til forespørselsinnholdet.

Merk: For data med flere deler, legg til Formverdier i stedet for å generere brødteksten.
Kroppsfil Skriv inn filen som inneholder JSON-objektet eller forespørselsparameterne som skal sendes i forespørselsteksten. Hvis du inkluderer dette, lar du Brødtekst stå tomt.
brødtekst

Skriv inn teksten som skal sendes i forespørselsteksten. Hvis du inkluderer dette, lar du Body-file stå tomt.
Tips: Hvis det finnes flervalgsparametere, bruk følgende mønster:

{ "spørringsID": "DIN_SPØRRESID", "parametere": { "dittParamnavn": ["verdi1", "verdi2"] } }
Topptekster Skriv inn eventuelle ekstra overskrifter som skal legges til i forespørselen.
Skjemaverdier For å generere brødteksten for flerdelte data, legg til skjemaverdiene som skal inkluderes i forespørselen, og skriv inn navn og verdi for hver. Hvis du legger til skjemaverdier, lar du Innholdstype stå tomt.
Utdataskjema For å aktivere senere kommandoer i kjeden til å få tilgang til utdataegenskapene til denne kommandoen, angi en eksempelnyttelast for hver JSON-utdata. 

Utganger

Utdata Utgangstype
Svaroverskrifter JSON
Svar Fil
Svarkode Heltall

Utgangskoder

Kode Type Detalj
0 Vellykket Vellykket
2 Feil Forespørsel mislyktes; ikke-200-svarkode
4 Feil Sertifikatet ble ikke funnet
5 Feil Ugyldige forespørselshoder

Sette

For å endre eller oppdatere en ressurs, bruk en Put -kommando. Denne kommandoen foretar en HTTP PUT -forespørsel, for eksempel https://postman-echo.com/put.

Egenskaper

Egenskap Detalj
Brukernavn Hvis grunnleggende autentisering er nødvendig, skriv inn brukernavnet.
Passord Hvis grunnleggende autentisering er nødvendig, skriv inn passordet.
CA-sertifikat Angi CA-sertifikatet som skal brukes når du sender forespørselen (valgfritt).
Sertifikat Skriv inn sertifikatet som skal sendes med forespørselen (valgfritt). Hvis oppgitt, skriv også inn Sertifikatets private nøkkel.
Privat nøkkel for sertifikat Skriv inn den private nøkkelen for Sertifikat, hvis oppgitt.
Vis svar For å vise API-svarinnholdet i utdataene, merk av i denne boksen.
URL Skriv inn URL-en som ble brukt for forespørselen.
Innholdstype

Skriv inn innholdstypehodet som skal angis. Dette angir det forventede formatet som skal sendes til forespørselsinnholdet.

Merk: For data med flere deler, legg til Formverdier i stedet for å generere brødteksten.
Kroppsfil Skriv inn filen som inneholder JSON-objektet eller forespørselsparameterne som skal sendes i forespørselsteksten. Hvis du inkluderer dette, lar du Brødtekst stå tomt.
brødtekst Skriv inn teksten som skal sendes i forespørselsteksten. Hvis du inkluderer dette, lar du Body-file stå tomt.
Topptekster Skriv inn eventuelle ekstra overskrifter som skal legges til i forespørselen.
Skjemaverdier For å generere brødteksten for flerdelte data, legg til skjemaverdiene som skal inkluderes i forespørselen, og skriv inn navn og verdi for hver. Hvis du legger til skjemaverdier, lar du Innholdstype stå tomt.
Utdataskjema For å aktivere senere kommandoer i kjeden til å få tilgang til utdataegenskapene til denne kommandoen, angi en eksempelnyttelast for hver JSON-utdata.

Utganger

Utdata Utgangstype
Svaroverskrifter JSON
Svar Fil
Svarkode Heltall

Utgangskoder

Kode Type Detalj
0 Vellykket Vellykket
2 Feil Forespørsel mislyktes; ikke-200-svarkode
4 Feil Sertifikatet ble ikke funnet
5 Feil Ugyldige forespørselshoder
En HTTP-forespørselstilkobling utfører disse kommandoene for å utføre vanlige HTTP-forespørsler (HyperText Transfer P...