|
Die klassischen Dateitypen können ab Januar 2021 nicht mehr verwendet werden. Sie können Ihre klassischen Dateien übertragen oder eine PDF herunterladen. Weitere Informationen

Workiva Support Center

HTTP-Anfrage-Befehle

HTTP-Anfrage-Befehle

  • Zuletzt aktualisiert am

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.
  • Um die gegenseitige TLS-Authentifizierung (mTLS) zu aktivieren, stellen Sie ein öffentliches/privates Schlüsselpaar und optional ein CA-Zertifikat bereit. Um den öffentlichen und den privaten Schlüssel zu verwenden, laden Sie 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

Exit-Codes

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

Abrufen

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 codiert sein.
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

Posten

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.
Tipp: Bei Mehrfachauswahlparametern nutzen Sie folgendes Muster:

{ „queryId“: „YOUR_QUERY_ID“, „parameters“: { „yourParamName“: ["value1“, „value2“] } }
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
Eine HTTP-Requests-Verbindung führt diese Befehle aus, um allgemeine HyperText Transfer Protocol (HTTP)-Anfragen an e...