|
Klassieke bestandstypen zijn vanaf januari 2021 niet meer beschikbaar voor gebruik. U kunt uw klassieke bestanden omzetten of een PDF downloaden. Meer informatie

Workiva-ondersteuningscentrum

HTTP-aanvraagopdrachten

HTTP-aanvraagopdrachten

  • Laatst bijgewerkt op

Een HTTP-verzoekenverbinding voert deze opdrachten uit om gewone HyperText Transfer Protocol (HTTP)-verzoeken uit te voeren naar een bepaalde URL om ondersteunde oplossingen via hun respectieve connectors te verbinden en te automatiseren.

Om te zien hoe een HTTP Request is opgebouwd, kunt u onze HTTP Connector voorbeeldlijst bekijken.

Opmerking: Hoewel dit gelabeld is als HTTP Request, wordt HTTPS (Secure HTTP) ondersteund (en aanbevolen).

Vereisten

  • Hoewel de verbinding geen OData-specifieke functies heeft, kunt u alle noodzakelijke componenten van het verzoek toevoegen via de parameters Headers of Query string.
  • Om wederzijdse TLS (mTLS) authenticatie in te schakelen, levert u een openbaar/privé sleutelpaar en, optioneel, een CA-certificaat. Om de openbare en privésleutels te gebruiken, uploadt u ze als werkruimtebronnen en selecteert u ze vervolgens voor de parameters Certificaat en Certificaat privésleutel van de opdracht.
  • Het bestand met de privésleutel mag niet versleuteld zijn. Het laden van een gecodeerd bestand als een privésleutel zal resulteren in een fout.

Om deze opdrachten in te schakelen, maakt een IT-beheerder eerst een HTTP Request connector.

Verwijderen

Om een bron te verwijderen, gebruikt u de opdracht Delete. Deze opdracht maakt een HTTP DELETE verzoek, zoals http://postman-echo.com/delete.

Eigenschappen

Eigendom Detail
Gebruikersnaam Als basisverificatie vereist is, voert u de gebruikersnaam in.
Wachtwoord Als basisverificatie vereist is, voert u het wachtwoord in.
CA-certificaat Voer het certificaat van de certificeringsinstantie (CA) in dat u wilt gebruiken bij de aanvraag (optioneel).
Certificaat Voer het certificaat in dat u met het verzoek wilt meesturen (optioneel). Indien aanwezig, voer dan ook Certificate private key in.
Certificaat privésleutel Voer de privésleutel in voor Certificate, indien meegeleverd.
Reactie tonen Vink dit vakje aan om de API respons body in de uitvoer te tonen.
URL Voer de URL in die wordt gebruikt voor de aanvraag, zoals http://postman-echo.com/delete.
Type inhoud Voer de koptekst van het inhoudstype in om in te stellen. Dit specificeert het verwachte formaat om naar de verzoektekst te sturen.
Lichaamsbestand Voer het bestand in dat het JSON-object of de verzoekparameters bevat die in de verzoektekst moeten worden verzonden. Als u dit opneemt, laat Body text dan leeg.
Tekst Voer de tekst in die u in de verzoektekst wilt verzenden. Als u dit opneemt, laat Body file dan leeg.
Koppen Voer eventuele extra headers in om aan het verzoek toe te voegen.

Uitgangen

Uitgang Type uitvoer
Response-headers JSON
Reactie Bestand
Antwoordcode Geheel getal

Afsluitcodes

Code type Detail
0 Succes Succes
2 Fout Aanvraag mislukt; niet-200 antwoordcode
4 Fout Certificaat niet gevonden
5 Fout Ongeldige verzoekheaders

Ga naar

Om een bron op te halen, gebruikt u een opdracht Get. Deze opdracht maakt een HTTP GET verzoek, zoals https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Opmerking: Deze opdracht bevat een spatie om queryparameters in te voeren -- parameters moeten niet in de URL zelf worden opgenomen. Als er parameters worden ingevoerd in zowel de URL als het veld "Query string", dan worden deze uit de URL verwijderd.

Eigenschappen

Eigendom Detail
Gebruikersnaam Als basisverificatie vereist is, voert u de gebruikersnaam in.
Wachtwoord Als basisverificatie vereist is, voert u het wachtwoord in.
CA-certificaat Voer het CA-certificaat in dat u wilt gebruiken bij de aanvraag (optioneel).
Certificaat Voer het certificaat in dat u met het verzoek wilt meesturen (optioneel). Indien aanwezig, voer dan ook Certificate private key in.
Certificaat privésleutel Voer de privésleutel in voor Certificate, indien meegeleverd.
Reactie tonen Vink dit vakje aan om de API respons body in de uitvoer te tonen.
URL Voer de URL in die wordt gebruikt voor de aanvraag, zoals https://postman-echo.com/get.
Querystring

Voer de querystring in om toe te voegen aan het verzoek, zoals foo1=bar1&foo2=bar2.

Opmerking: De querystring moet worden gecodeerd.
Koppen Voer eventuele extra headers in om aan het verzoek toe te voegen.
Type inhoud Voer de content-type header in die u wilt instellen, zoals application/json. Dit specificeert het verwachte formaat om naar de verzoektekst te sturen.
Uitvoer schema Om latere opdrachten in de keten toegang te geven tot de uitvoereigenschappen van deze opdracht, voert u voor elke JSON-uitvoer een voorbeeld payload in. 

Uitgangen

Uitgang Type uitvoer
Response-headers JSON
Reactie Bestand
Antwoordcode Geheel getal

Afsluitcodes

Code type Detail
0 Succes Succes
2 Fout Aanvraag mislukt; niet-200 antwoordcode
4 Fout Certificaat niet gevonden
5 Fout Ongeldige verzoekheaders

Posten

Om een resource te plaatsen, gebruikt u een Post opdracht. Deze opdracht maakt een HTTP POST verzoek, zoals https://postman-echo.com/post.

Eigenschappen

Eigendom Detail
Gebruikersnaam Als basisverificatie vereist is, voert u de gebruikersnaam in.
Wachtwoord Als basisverificatie vereist is, voert u het wachtwoord in.
CA-certificaat Voer het CA-certificaat in dat u wilt gebruiken bij de aanvraag (optioneel).
Certificaat Voer het certificaat in dat u met het verzoek wilt meesturen (optioneel). Indien aanwezig, voer dan ook Certificate private key in.
Certificaat privésleutel Voer de privésleutel in voor Certificate, indien meegeleverd.
Reactie tonen Vink dit vakje aan om de API respons body in de uitvoer te tonen.
URL Voer de URL in die wordt gebruikt voor de aanvraag, zoals https://postman-echo.com/post.
Type inhoud

Voer de koptekst van het inhoudstype in om in te stellen. Dit specificeert het verwachte formaat om naar de verzoektekst te sturen.

Opmerking: Voeg voor meerdelige gegevens Formulierwaarden toe om de body te genereren.
Lichaamsbestand Voer het bestand in dat het JSON-object of de verzoekparameters bevat die in de verzoektekst moeten worden verzonden. Als u dit opneemt, laat Body text dan leeg.
Tekst Voer de tekst in die u in de verzoektekst wilt verzenden. Als u dit opneemt, laat Body file dan leeg.
Koppen Voer eventuele extra headers in om aan het verzoek toe te voegen.
Formulierwaarden Om de body voor meerdelige gegevens te genereren, voegt u de formulierwaarden toe om in het verzoek op te nemen, en voert u voor elk de naam en waarde in. Als u formulierwaarden toevoegt, laat Inhoudstype dan leeg.
Uitvoerschema Om latere opdrachten in de keten toegang te geven tot de uitvoereigenschappen van deze opdracht, voert u voor elke JSON-uitvoer een voorbeeld payload in. 

Uitgangen

Uitgang Type uitvoer
Response-headers JSON
Reactie Bestand
Antwoordcode Geheel getal

Afsluitcodes

Code type Detail
0 Succes Succes
2 Fout Aanvraag mislukt; niet-200 antwoordcode
4 Fout Certificaat niet gevonden
5 Fout Ongeldige verzoekheaders

Zet

Om een bron te wijzigen of bij te werken, gebruikt u een opdracht Put. Deze opdracht maakt een HTTP PUT verzoek, zoals https://postman-echo.com/put.

Eigenschappen

Eigendom Detail
Gebruikersnaam Als basisverificatie vereist is, voert u de gebruikersnaam in.
Wachtwoord Als basisverificatie vereist is, voert u het wachtwoord in.
CA-certificaat Voer het CA-certificaat in dat u wilt gebruiken bij de aanvraag (optioneel).
Certificaat Voer het certificaat in dat u met het verzoek wilt meesturen (optioneel). Indien aanwezig, voer dan ook Certificate private key in.
Certificaat privésleutel Voer de privésleutel in voor Certificate, indien meegeleverd.
Reactie tonen Vink dit vakje aan om de API respons body in de uitvoer te tonen.
URL Voer de URL in die voor de aanvraag wordt gebruikt.
Type inhoud

Voer de koptekst van het inhoudstype in om in te stellen. Dit specificeert het verwachte formaat om naar de verzoektekst te sturen.

Opmerking: Voeg voor meerdelige gegevens Formulierwaarden toe om de body te genereren.
Lichaamsbestand Voer het bestand in dat het JSON-object of de verzoekparameters bevat die in de verzoektekst moeten worden verzonden. Als u dit opneemt, laat Body text dan leeg.
Tekst Voer de tekst in die u in de verzoektekst wilt verzenden. Als u dit opneemt, laat Body file dan leeg.
Koppen Voer eventuele extra headers in om aan het verzoek toe te voegen.
Formulierwaarden Om de body voor meerdelige gegevens te genereren, voegt u de formulierwaarden toe om in het verzoek op te nemen, en voert u voor elk de naam en waarde in. Als u formulierwaarden toevoegt, laat Inhoudstype dan leeg.
Uitvoerschema Om latere opdrachten in de keten toegang te geven tot de uitvoereigenschappen van deze opdracht, voert u voor elke JSON-uitvoer een voorbeeld payload in.

Uitgangen

Uitgang Type uitvoer
Response-headers JSON
Reactie Bestand
Antwoordcode Geheel getal

Afsluitcodes

Code type Detail
0 Succes Succes
2 Fout Aanvraag mislukt; niet-200 antwoordcode
4 Fout Certificaat niet gevonden
5 Fout Ongeldige verzoekheaders
Was dit artikel nuttig?
Aantal gebruikers dat dit nuttig vond: 2 van 8
Een HTTP-verzoekenverbinding voert deze opdrachten uit om gewone HyperText Transfer Protocol (HTTP)-verzoeken uit te ...