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.
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) aktivierenund ein öffentliches/privates Schlüsselpaar sowie optional ein CA-Zertifikat bereitstellen. Um den öffentlichen und den privaten Schlüssel zu verwenden, laden Sie als Arbeitsbereichsressourcenhoch und wählen sie dann für die Parameter Zertifikat und Zertifikat privater Schlüssel aus.
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
| Eigentum |
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 Certificate private keyein. |
| 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. |
| Art des Inhalts |
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 |
Erfolg |
Erfolg |
| 2 |
Fehler |
Anfrage fehlgeschlagen; non-200 Antwortcode |
| 4 |
Fehler |
Zertifikat nicht gefunden |
| 5 |
Fehler |
Ungültige Anfrage-Header |
Siehe
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
| Eigentum |
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 Certificate private keyein. |
| 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-String |
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. |
| Art des Inhalts |
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 |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 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
| Eigentum |
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 Certificate private keyein. |
| 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. |
| Art des Inhalts |
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 |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 2 |
Fehler |
Anfrage fehlgeschlagen; non-200 Antwortcode |
| 4 |
Fehler |
Zertifikat nicht gefunden |
| 5 |
Fehler |
Ungültige Anfrage-Header |
Setzen Sie
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
| Eigentum |
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 Certificate private keyein. |
| 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. |
| Art des Inhalts |
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 |
Exit-Codes
| Code |
Typ |
Einzelheiten |
| 0 |
Erfolg |
Erfolg |
| 2 |
Fehler |
Anfrage fehlgeschlagen; non-200 Antwortcode |
| 4 |
Fehler |
Zertifikat nicht gefunden |
| 5 |
Fehler |
Ungültige Anfrage-Header |