HTTP-Anfrage-Befehle

Eine HTTP-Requests-Verbindung führt diese Befehle aus, um allgemeine HyperText Transfer Protocol (HTTP)-Anfragen an eine bestimmte URL auszuführen, um unterstützte Lösungen über ihre jeweiligen Konnektoren zu verbinden und zu automatisieren.

Um zu sehen, wie eine HTTP-Anfrage aufgebaut ist, sehen Sie sich unsere HTTP Connector Beispielliste an.

Hinweis: Obwohl dies als HTTP-Anfrage gekennzeichnet ist, wird HTTPS (Secure HTTP) unterstützt (und empfohlen).

Anforderungen

Obwohl die Verbindung keine OData-spezifischen Funktionen hat, können Sie alle notwendigen Komponenten der Anfrage über die Parameter Headers oder Query string hinzufügen.
Unter können Sie die gegenseitige TLS-Authentifizierung (mTLS) aktivieren und ein öffentliches/privates Schlüsselpaar sowie optional ein CA-Zertifikat bereitstellen. Um den öffentlichen und den privaten Schlüssel zu verwenden, laden Sie als Arbeitsbereichsressourcen hoch und wählen sie dann für die Parameter Zertifikat und Zertifikat privater Schlüssel aus.
Die Datei, die den privaten Schlüssel enthält, darf nicht verschlüsselt sein. Das Laden einer verschlüsselten Datei als privater Schlüssel führt zu einem Fehler.

Um diese Befehle zu aktivieren, erstellt ein IT-Administrator zunächst einen HTTP Request Connector.

Löschen

Um eine Ressource zu entfernen, verwenden Sie den Befehl Delete. Mit diesem Befehl wird eine HTTP DELETE -Anfrage gestellt, z. B. http://postman-echo.com/delete.

Eigenschaften

Eigenschaft	Einzelheiten
Benutzername	Wenn eine grundlegende Authentifizierung erforderlich ist, geben Sie den Benutzernamen ein.
Kennwort	Wenn eine Basisauthentifizierung erforderlich ist, geben Sie das Passwort ein.
CA-Zertifikat	Geben Sie das Zertifikat der Zertifizierungsstelle (CA) ein, das für die Anforderung verwendet werden soll (optional).
Zertifikat	Geben Sie das Zertifikat ein, das mit der Anfrage gesendet werden soll (optional). Falls vorhanden, geben Sie auch privaten Zertifikatschlüssel ein.
Privater Schlüssel des Zertifikats	Geben Sie den privaten Schlüssel für das Zertifikat ein, falls vorhanden.
Antwort anzeigen	Um den API-Antwortkörper in der Ausgabe anzuzeigen, markieren Sie dieses Feld.
URL	Geben Sie die für die Anfrage verwendete URL ein, z. B. `http://postman-echo.com/delete`.
Inhaltstyp	Geben Sie den zu setzenden Content-Type-Header ein. Hier wird das erwartete Format für die Übermittlung an den Anfragekörper angegeben.
Body-Datei	Geben Sie die Datei an, die das JSON-Objekt oder die Anforderungsparameter enthält, die im Hauptteil der Anforderung gesendet werden sollen. Wenn Sie dies angeben, lassen Sie Body text leer.
Haupttext	Geben Sie den zu sendenden Text in den Textkörper der Anfrage ein. Wenn Sie dies angeben, lassen Sie Body file leer.
Kopfzeilen	Geben Sie alle zusätzlichen Kopfzeilen ein, die der Anfrage hinzugefügt werden sollen.

Ausgaben

Ausgabe	Art der Ausgabe
Antwort-Kopfzeilen	JSON
Antwort	Datei
Antwort-Code	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
2	Fehler	Anfrage fehlgeschlagen; non-200-Antwortcode
4	Fehler	Zertifikat nicht gefunden
5	Fehler	Ungültige Anfrage-Header

Get

Um eine Ressource abzurufen, verwenden Sie den Befehl Get. Mit diesem Befehl wird eine HTTP GET -Anfrage gestellt, beispielsweise https://postman-echo.com/get?foo1=bar1&foo2=bar2.

Hinweis: Dieser Befehl enthält ein Leerzeichen für die Eingabe von Abfrageparametern - die Parameter sollten nicht in der URL selbst enthalten sein. Wenn Parameter sowohl in der URL als auch im Feld "Abfrage-String" eingegeben werden, werden sie aus der URL entfernt.

Eigenschaften

Eigenschaft	Einzelheiten
Benutzername	Wenn eine grundlegende Authentifizierung erforderlich ist, geben Sie den Benutzernamen ein.
Kennwort	Wenn eine Basisauthentifizierung erforderlich ist, geben Sie das Passwort ein.
CA-Zertifikat	Geben Sie das CA-Zertifikat ein, das für die Anforderung verwendet werden soll (optional).
Zertifikat	Geben Sie das Zertifikat ein, das mit der Anfrage gesendet werden soll (optional). Falls vorhanden, geben Sie auch privaten Zertifikatschlüssel ein.
Privater Schlüssel des Zertifikats	Geben Sie den privaten Schlüssel für das Zertifikat ein, falls vorhanden.
Antwort anzeigen	Um den API-Antwortkörper in der Ausgabe anzuzeigen, markieren Sie dieses Feld.
URL	Geben Sie die für die Anfrage verwendete URL ein, z. B. `https://postman-echo.com/get`.
Abfrage-Zeichenfolge	Geben Sie die Abfragezeichenfolge ein, die an die Anfrage angehängt werden soll, z. B. `foo1=bar1&foo2=bar2`. Hinweis: Die Abfragezeichenfolge muss verschlüsselt werden.
Kopfzeilen	Geben Sie alle zusätzlichen Kopfzeilen ein, die der Anfrage hinzugefügt werden sollen.
Inhaltstyp	Geben Sie den zu setzenden Content-Type-Header ein, z. B. `application/json`. Hier wird das erwartete Format für die Übermittlung an den Anfragekörper angegeben.
Ausgabeschema	Damit spätere Befehle in der Kette auf die Ausgabeeigenschaften dieses Befehls zugreifen können, geben Sie für jede JSON-Ausgabe eine Beispiel-Nutzlast ein.

Ausgaben

Ausgabe	Art der Ausgabe
Antwort-Kopfzeilen	JSON
Antwort	Datei
Antwort-Code	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
2	Fehler	Anfrage fehlgeschlagen; non-200-Antwortcode
4	Fehler	Zertifikat nicht gefunden
5	Fehler	Ungültige Anfrage-Header

Veröffentlichen

Um eine Ressource zu platzieren, verwenden Sie einen Post Befehl. Mit diesem Befehl wird eine HTTP POST -Anfrage gestellt, z. B. https://postman-echo.com/post.

Eigenschaften

Eigenschaft	Einzelheiten
Benutzername	Wenn eine grundlegende Authentifizierung erforderlich ist, geben Sie den Benutzernamen ein.
Kennwort	Wenn eine Basisauthentifizierung erforderlich ist, geben Sie das Passwort ein.
CA-Zertifikat	Geben Sie das CA-Zertifikat ein, das für die Anforderung verwendet werden soll (optional).
Zertifikat	Geben Sie das Zertifikat ein, das mit der Anfrage gesendet werden soll (optional). Falls vorhanden, geben Sie auch privaten Zertifikatschlüssel ein.
Privater Schlüssel des Zertifikats	Geben Sie den privaten Schlüssel für das Zertifikat ein, falls vorhanden.
Antwort anzeigen	Um den API-Antwortkörper in der Ausgabe anzuzeigen, markieren Sie dieses Feld.
URL	Geben Sie die für die Anfrage verwendete URL ein, z. B. `https://postman-echo.com/post`.
Inhaltstyp	Geben Sie den zu setzenden Content-Type-Header ein. Hier wird das erwartete Format für die Übermittlung an den Anfragekörper angegeben. Hinweis: Bei mehrteiligen Daten fügen Sie stattdessen Formularwerte hinzu, um den Textkörper zu erzeugen.
Body-Datei	Geben Sie die Datei an, die das JSON-Objekt oder die Anforderungsparameter enthält, die im Hauptteil der Anforderung gesendet werden sollen. Wenn Sie dies angeben, lassen Sie Body text leer.
Haupttext	Geben Sie den zu sendenden Text in den Textkörper der Anfrage ein. Wenn Sie dies angeben, lassen Sie Body file leer.
Kopfzeilen	Geben Sie alle zusätzlichen Kopfzeilen ein, die der Anfrage hinzugefügt werden sollen.
Formularwerte	Um den Textkörper für mehrteilige Daten zu erstellen, fügen Sie die Formularwerte hinzu, die in die Anfrage aufgenommen werden sollen, und geben Sie den Namen und den Wert für jeden Wert ein. Wenn Sie Formularwerte hinzufügen, lassen Sie Inhaltstyp leer.
Ausgabeschema	Damit spätere Befehle in der Kette auf die Ausgabeeigenschaften dieses Befehls zugreifen können, geben Sie für jede JSON-Ausgabe eine Beispiel-Nutzlast ein.

Ausgaben

Ausgabe	Art der Ausgabe
Antwort-Kopfzeilen	JSON
Antwort	Datei
Antwort-Code	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
2	Fehler	Anfrage fehlgeschlagen; non-200-Antwortcode
4	Fehler	Zertifikat nicht gefunden
5	Fehler	Ungültige Anfrage-Header

Put

Um eine Ressource zu ändern oder zu aktualisieren, verwenden Sie einen Put Befehl. Mit diesem Befehl wird eine HTTP PUT -Anfrage gestellt, z. B. https://postman-echo.com/put.

Eigenschaften

Eigenschaft	Einzelheiten
Benutzername	Wenn eine grundlegende Authentifizierung erforderlich ist, geben Sie den Benutzernamen ein.
Kennwort	Wenn eine Basisauthentifizierung erforderlich ist, geben Sie das Passwort ein.
CA-Zertifikat	Geben Sie das CA-Zertifikat ein, das für die Anforderung verwendet werden soll (optional).
Zertifikat	Geben Sie das Zertifikat ein, das mit der Anfrage gesendet werden soll (optional). Falls vorhanden, geben Sie auch privaten Zertifikatschlüssel ein.
Privater Schlüssel des Zertifikats	Geben Sie den privaten Schlüssel für das Zertifikat ein, falls vorhanden.
Antwort anzeigen	Um den API-Antwortkörper in der Ausgabe anzuzeigen, markieren Sie dieses Feld.
URL	Geben Sie die für die Anfrage verwendete URL ein.
Inhaltstyp	Geben Sie den zu setzenden Content-Type-Header ein. Hier wird das erwartete Format für die Übermittlung an den Anfragekörper angegeben. Hinweis: Bei mehrteiligen Daten fügen Sie stattdessen Formularwerte hinzu, um den Textkörper zu erzeugen.
Body-Datei	Geben Sie die Datei an, die das JSON-Objekt oder die Anforderungsparameter enthält, die im Hauptteil der Anforderung gesendet werden sollen. Wenn Sie dies angeben, lassen Sie Body text leer.
Haupttext	Geben Sie den zu sendenden Text in den Textkörper der Anfrage ein. Wenn Sie dies angeben, lassen Sie Body file leer.
Kopfzeilen	Geben Sie alle zusätzlichen Kopfzeilen ein, die der Anfrage hinzugefügt werden sollen.
Formularwerte	Um den Textkörper für mehrteilige Daten zu erstellen, fügen Sie die Formularwerte hinzu, die in die Anfrage aufgenommen werden sollen, und geben Sie den Namen und den Wert für jeden Wert ein. Wenn Sie Formularwerte hinzufügen, lassen Sie Inhaltstyp leer.
Ausgabeschema	Damit spätere Befehle in der Kette auf die Ausgabeeigenschaften dieses Befehls zugreifen können, geben Sie für jede JSON-Ausgabe eine Beispiel-Nutzlast ein.

Ausgaben

Ausgabe	Art der Ausgabe
Antwort-Kopfzeilen	JSON
Antwort	Datei
Antwort-Code	Ganzzahl

Codes beenden

Code	Typ	Einzelheiten
0	Erfolgreich	Erfolgreich
2	Fehler	Anfrage fehlgeschlagen; non-200-Antwortcode
4	Fehler	Zertifikat nicht gefunden
5	Fehler	Ungültige Anfrage-Header

Support

Community

Workiva Support Center