HTTP >Erstellen einer API-Schlüsselautorisierungsanforderung

Adobe Workfront plan*

Pro oder höher

Adobe Workfront license*

Plan, Arbeit

Adobe Workfront Fusion license**

Aktuelle Lizenzanforderungen: Keine Workfront Fusion Lizenzanforderungen.

Oder

Alte Lizenzanforderung: Workfront Fusion für die Arbeitsautomatisierung und -integration

Produkt

Aktuelle Produktanforderung: Wenn Sie über den Select- oder Prime Adobe Workfront-Plan verfügen, muss Ihr Unternehmen Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebene Funktionalität nutzen zu können. Workfront Fusion ist im Ultimate Workfront-Plan enthalten.

Oder

Alte Produktanforderung: Ihr Unternehmen muss Adobe Workfront Fusion sowie Adobe Workfront erwerben, um die in diesem Artikel beschriebenen Funktionen nutzen zu können.

Credentials

Wählen Sie den Schlüssel aus, der Ihre Anmeldedaten für die API-Schlüsselauthentifizierung enthält. Um einen neuen Schlüssel hinzuzufügen, klicken Sie auf Add und konfigurieren Sie die folgenden Informationen:

• Schlüsselname

  Geben Sie einen Namen für diesen Satz von API-Anmeldeinformationen ein.

• Schlüssel

  Geben Sie den API-Schlüssel ein.

• API Key placement

  Wählen Sie aus, ob der API-Schlüssel in der Kopfzeile oder in der Abfrage des API-Aufrufs platziert werden soll.

• API Key Parameter name

  Geben Sie den Namen ein, mit dem der API-Aufruf den API-Schlüssel identifiziert, z. B. "apiKey"oder "X-API-Schlüssel". Diese Informationen finden Sie in der Dokumentation des Webdienstes, mit dem das Modul eine Verbindung herstellt.

Alle Status als Fehler auswerten (mit Ausnahme von 2xx und 3xx)

Verwenden Sie diese Option, um die Fehlerbehandlung einzurichten.

Weitere Informationen finden Sie unter Umgang mit Fehlern in Adobe Workfront Fusion.

URL

Geben Sie die URL ein, an die Sie eine Anfrage senden möchten, z. B. einen API-Endpunkt, eine Website usw.

Methode

Wählen Sie die HTTP-Anfragemethode aus, die Sie zum Konfigurieren des API-Aufrufs benötigen. Weitere Informationen finden Sie unter HTTP-Anforderungsmethoden in Adobe Workfront Fusion.

Header

Fügen Sie die Header der Anfrage in Form eines standardmäßigen JSON-Objekts hinzu. Beispiel: {"Content-type":"application/json"}

Abfragezeichenfolge

Geben Sie die gewünschten Schlüssel-Wert-Paare für die Abfrage ein.

Textkörper

Der HTTP-Hauptteil sind die Daten-Bytes, die in einer HTTP-Transaktionsnachricht unmittelbar auf die Header übertragen werden, sofern welche verwendet werden sollen.

• Raw

  Der Rohkörpertyp eignet sich im Allgemeinen für die meisten HTTP-Textkörperanforderungen, selbst wenn in der Entwicklerdokumentation keine zu sendenden Daten angegeben sind.

  Geben Sie im Feld Inhaltstyp eine Form zum Analysieren der Daten an.

  Ungeachtet des ausgewählten Inhaltstyps gibt das Modul Daten in einem beliebigen Format ein, das in der Entwicklerdokumentation festgelegt oder benötigt wird.

• Application/x-www-form-urlencoded

  Dieser Nachrichtentyp wird zu POST-Daten mit application/x-www-form-urlencoded verwendet.

  Bei application/x-www-form-urlencoded ist der Hauptteil der an den Server gesendeten HTTP-Nachricht im Wesentlichen eine Abfragezeichenfolge. Die Schlüssel und Werte werden in Schlüssel-Wert-Paaren kodiert, die durch & getrennt sind, und in einem = zwischen Schlüssel und Wert.

  Verwenden Sie stattdessen für Binärdaten "multipart/form-data".

  Beispiel:

  Beispiel für das resultierende HTTP-Anforderungsformat:

  field1=value1&field2=value2

• Multipart/form-data

  Multipart/form-data ist eine HTTP-Multipart-Anfrage zum Senden von Dateien und Daten. Sie wird häufig zum Hochladen von Dateien auf den Server verwendet.

  Fügen Sie Felder hinzu, die in der Anfrage gesendet werden sollen. Jedes Feld muss ein Schlüssel-Wert-Paar enthalten.

  • Text

    Geben Sie den Schlüssel und den Wert ein, die im Anfrageinhalt gesendet werden sollen.

  • Datei

    Geben Sie den Schlüssel ein und geben Sie im Anfragetext die Quelldatei an, die Sie senden möchten.

    Ordnen Sie die Datei zu, die Sie vom vorherigen Modul hochladen möchten (z. B. HTTP >Datei abrufen oder Google Drive >Datei herunterladen), oder geben Sie den Dateinamen und die Dateidaten manuell ein.

Parse response

Aktivieren Sie diese Option, um Antworten automatisch zu analysieren und JSON- und XML-Antworten zu konvertieren, sodass Sie nicht JSON > Parse JSON oder XML > Parse XML Module verwenden müssen.

Bevor Sie geparsten JSON- oder XML-Inhalt verwenden können, führen Sie das Modul einmal manuell aus, damit das Modul den Antwortinhalt erkennen und ihn in nachfolgenden Modulen zuordnen kann.

Timeout

Geben Sie die Zeitüberschreitung der Anfrage in Sekunden (1-300) an. Der Standardwert beträgt 40 Sekunden.

Cookies mit anderen HTTP-Modulen teilen

Aktivieren Sie diese Option, um Cookies vom Server für alle HTTP-Module in Ihrem Szenario freizugeben.

Selbstsigniertes Zertifikat

Laden Sie das Zertifikat hoch, wenn Sie TLS mit Ihrem selbst signierten Zertifikat verwenden möchten.

Ablehnen von Verbindungen, die nicht überprüfte (selbstsignierte) Zertifikate verwenden

Aktivieren Sie diese Option, um Verbindungen abzulehnen, die nicht überprüfte TLS-Zertifikate verwenden.

Weiterleitung

Aktivieren Sie diese Option, um URL-Umleitungen mit 3xx-Antworten zu folgen.

Alle Umleitungen folgen

Aktivieren Sie diese Option, um den URL-Umleitungen mit allen Antwort-Codes zu folgen.

Deaktivieren der Serialisierung mehrerer Abfragezeichenfolgenschlüssel als Arrays

Standardmäßig verarbeitet Workfront Fusion mehrere Werte für denselben URL-Abfragezeichenfolgen-Parameterschlüssel wie Arrays. Beispielsweise wird www.test.com?foo=bar&foo=baz in www.test.com?foo[0]=bar&foo[1]=baz umgewandelt. Aktivieren Sie diese Option, um diese Funktion zu deaktivieren.

Komprimierten Inhalt anfordern

Aktivieren Sie diese Option, um eine komprimierte Version der Website anzufordern.

Fügt eine Accept-Encoding -Kopfzeile hinzu, um komprimierten Inhalt anzufordern.

Gegenseitige TLS verwenden

Aktivieren Sie diese Option, um in der HTTP-Anforderung die Verwendung von TLS mit Gegenseitigkeit vorzunehmen.

Weitere Informationen zu TLS auf Gegenseitige Basis finden Sie unter Verwenden von TLS auf Gegenseitiger Basis in HTTP-Modulen in Adobe Workfront Fusion.