|
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-verzoekopdrachten

HTTP-verzoekopdrachten

  • Laatst bijgewerkt op

Een HTTP Requests-verbinding voert deze opdrachten uit om veelvoorkomende HTTP-verzoeken (HyperText Transfer Protocol) naar een bepaalde URL te verzenden, waarmee ondersteunde oplossingen via hun respectievelijke connectors worden verbonden en geautomatiseerd.

Om te zien hoe een HTTP-verzoek is opgebouwd, raadpleegt u onze lijst met voorbeelden van HTTP-connectoren.

Opmerking: Hoewel dit is gelabeld als HTTP-verzoek, wordt HTTPS (beveiligde HTTP) ondersteund (en aanbevolen).

Vereisten

  • Hoewel de verbinding geen OData-specifieke functies heeft, kunt u alle benodigde onderdelen van het verzoek toevoegen via de parameters Headers of Query string.
  • Om wederzijdse TLS-authenticatie (mTLS) in te schakelen, moetu een publiek/privaat sleutelpaar en, optioneel, een CA-certificaat opgeven. Om de publieke en private sleutels te gebruiken, uploadt u ze alswerkruimtebronnen en selecteert u ze vervolgens voor de parameters Certificaat en Privésleutel certificaatvan de opdracht.
  • Het bestand met de privésleutel mag niet versleuteld zijn. Het laden van een versleuteld bestand als privésleutel zal een foutmelding opleveren.

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

Verwijderen

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

Eigenschappen

Eigendom Detail
Gebruikersnaam Als basisverificatie vereist is, voer dan de gebruikersnaam in.
Wachtwoord Als basisverificatie vereist is, voer dan het wachtwoord in.
CA-certificaat Voer het certificaat van de certificeringsinstantie (CA) in dat u wilt gebruiken bij het indienen van het verzoek (optioneel).
Certificaat Voer het certificaat in dat met het verzoek moet worden meegestuurd (optioneel). Indien aanwezig, voer ook Privésleutel certificaatin.
privésleutel van het certificaat Voer de privésleutel in voor Certificaat, indien beschikbaar.
Toon reactie Om de API-responsbody in de uitvoer weer te geven, vinkt u dit vakje aan.
URL Voer de URL in die voor het verzoek is gebruikt, bijvoorbeeld http://postman-echo.com/delete.
Inhoudstype Voer de gewenste content-type header in. Dit specificeert het verwachte formaat dat naar de request body moet worden verzonden.
Bestandsinhoud Voer het bestand in dat het JSON-object of de verzoekparameters bevat die in de verzoekbody moeten worden verzonden. Als je dit toevoegt, laat je Tekst leeg.
Hoofdtekst Voer de tekst in die u in de aanvraagbody wilt verzenden. Als je dit toevoegt, laat dan Body file leeg.
Kopteksten Voer eventuele extra headers in die aan het verzoek moeten worden toegevoegd.

Uitgangen

Uitvoer Uitvoertype
Reactieheaders JSON
Antwoord Bestand
Reactiecode Geheel getal

Uitgangscodes

Code type Detail
0 Succes Succes
2 Fout Verzoek mislukt; responscode anders dan 200
4 Fout Certificaat niet gevonden
5 Fout Ongeldige aanvraagheaders

Krijgen

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

Opmerking: Deze opdracht bevat een spatie voor het invoeren van queryparameters -- parameters mogen niet in de URL zelf worden opgenomen. Als parameters zowel in de URL als in het veld "Query string" zijn ingevoerd, worden ze uit de URL verwijderd.

Eigenschappen

Eigendom Detail
Gebruikersnaam Als basisverificatie vereist is, voer dan de gebruikersnaam in.
Wachtwoord Als basisverificatie vereist is, voer dan het wachtwoord in.
CA-certificaat Voer het CA-certificaat in dat u wilt gebruiken bij het indienen van het verzoek (optioneel).
Certificaat Voer het certificaat in dat met het verzoek moet worden meegestuurd (optioneel). Indien aanwezig, voer ook Privésleutel certificaatin.
privésleutel van het certificaat Voer de privésleutel in voor Certificaat, indien beschikbaar.
Toon reactie Om de API-responsbody in de uitvoer weer te geven, vinkt u dit vakje aan.
URL Voer de URL in die voor het verzoek is gebruikt, bijvoorbeeld https://postman-echo.com/get.
Queryreeks

Voer de queryreeks in die aan het verzoek moet worden toegevoegd, bijvoorbeeld foo1=bar1&foo2=bar2.

Opmerking: De queryreeks moet gecodeerd zijn.
Kopteksten Voer eventuele extra headers in die aan het verzoek moeten worden toegevoegd.
Inhoudstype Voer de content-type header in die u wilt instellen, bijvoorbeeld application/json. Dit specificeert het verwachte formaat dat naar de request body moet worden verzonden.
Uitvoerschema Om latere opdrachten in de reeks toegang te geven tot de uitvoereigenschappen van deze opdracht, voert u een voorbeeldpayload in voor elke JSON-uitvoer. 

Uitgangen

Uitvoer Uitvoertype
Reactieheaders JSON
Antwoord Bestand
Reactiecode Geheel getal

Uitgangscodes

Code type Detail
0 Succes Succes
2 Fout Verzoek mislukt; responscode anders dan 200
4 Fout Certificaat niet gevonden
5 Fout Ongeldige aanvraagheaders

Posten

Om een ​​resource te plaatsen, gebruik je een Post commando. Deze opdracht maakt een HTTP POST verzoek, zoals https://postman-echo.com/post.

Eigenschappen

Eigendom Detail
Gebruikersnaam Als basisverificatie vereist is, voer dan de gebruikersnaam in.
Wachtwoord Als basisverificatie vereist is, voer dan het wachtwoord in.
CA-certificaat Voer het CA-certificaat in dat u wilt gebruiken bij het indienen van het verzoek (optioneel).
Certificaat Voer het certificaat in dat met het verzoek moet worden meegestuurd (optioneel). Indien aanwezig, voer ook Privésleutel certificaatin.
privésleutel van het certificaat Voer de privésleutel in voor Certificaat, indien beschikbaar.
Toon reactie Om de API-responsbody in de uitvoer weer te geven, vinkt u dit vakje aan.
URL Voer de URL in die voor het verzoek is gebruikt, bijvoorbeeld https://postman-echo.com/post.
Inhoudstype

Voer de gewenste content-type header in. Dit specificeert het verwachte formaat dat naar de request body moet worden verzonden.

Opmerking: Voor gegevens met meerdere onderdelen, voeg Formulierwaarden toe om de inhoud te genereren.
Bestandsinhoud Voer het bestand in dat het JSON-object of de verzoekparameters bevat die in de verzoekbody moeten worden verzonden. Als je dit toevoegt, laat je Tekst leeg.
Hoofdtekst

Voer de tekst in die u in de aanvraagbody wilt verzenden. Als je dit toevoegt, laat dan Body file leeg.
Tip: Als er parameters zijn die meerdere selecties vereisen, gebruik dan het volgende patroon:

{ "queryId": "YOUR_QUERY_ID", "parameters": { "yourParamName": ["value1", "value2"] } }
Kopteksten Voer eventuele extra headers in die aan het verzoek moeten worden toegevoegd.
Vormwaarden Om de body voor multipart-data te genereren, voegt u de formulierwaarden toe die in het verzoek moeten worden opgenomen en voert u voor elke waarde de naam en waarde in. Als u formulierwaarden toevoegt, laat u Inhoudstype leeg.
Uitvoerschema Om latere opdrachten in de reeks toegang te geven tot de uitvoereigenschappen van deze opdracht, voert u een voorbeeldpayload in voor elke JSON-uitvoer. 

Uitgangen

Uitvoer Uitvoertype
Reactieheaders JSON
Antwoord Bestand
Reactiecode Geheel getal

Uitgangscodes

Code type Detail
0 Succes Succes
2 Fout Verzoek mislukt; responscode anders dan 200
4 Fout Certificaat niet gevonden
5 Fout Ongeldige aanvraagheaders

Neerzetten

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

Eigenschappen

Eigendom Detail
Gebruikersnaam Als basisverificatie vereist is, voer dan de gebruikersnaam in.
Wachtwoord Als basisverificatie vereist is, voer dan het wachtwoord in.
CA-certificaat Voer het CA-certificaat in dat u wilt gebruiken bij het indienen van het verzoek (optioneel).
Certificaat Voer het certificaat in dat met het verzoek moet worden meegestuurd (optioneel). Indien aanwezig, voer ook Privésleutel certificaatin.
privésleutel van het certificaat Voer de privésleutel in voor Certificaat, indien beschikbaar.
Toon reactie Om de API-responsbody in de uitvoer weer te geven, vinkt u dit vakje aan.
URL Voer de URL in die voor het verzoek is gebruikt.
Inhoudstype

Voer de gewenste content-type header in. Dit specificeert het verwachte formaat dat naar de request body moet worden verzonden.

Opmerking: Voor gegevens met meerdere onderdelen, voeg Formulierwaarden toe om de inhoud te genereren.
Bestandsinhoud Voer het bestand in dat het JSON-object of de verzoekparameters bevat die in de verzoekbody moeten worden verzonden. Als je dit toevoegt, laat je Tekst leeg.
Hoofdtekst Voer de tekst in die u in de aanvraagbody wilt verzenden. Als je dit toevoegt, laat dan Body file leeg.
Kopteksten Voer eventuele extra headers in die aan het verzoek moeten worden toegevoegd.
Vormwaarden Om de body voor multipart-data te genereren, voegt u de formulierwaarden toe die in het verzoek moeten worden opgenomen en voert u voor elke waarde de naam en waarde in. Als u formulierwaarden toevoegt, laat u Inhoudstype leeg.
Uitvoerschema Om latere opdrachten in de reeks toegang te geven tot de uitvoereigenschappen van deze opdracht, voert u een voorbeeldpayload in voor elke JSON-uitvoer.

Uitgangen

Uitvoer Uitvoertype
Reactieheaders JSON
Antwoord Bestand
Reactiecode Geheel getal

Uitgangscodes

Code type Detail
0 Succes Succes
2 Fout Verzoek mislukt; responscode anders dan 200
4 Fout Certificaat niet gevonden
5 Fout Ongeldige aanvraagheaders
Een HTTP Requests-verbinding voert deze opdrachten uit om veelvoorkomende HTTP-verzoeken (HyperText Transfer Protocol...