HTTP > Erstellen einer API-Schlüssel-Autorisierungsanfrage

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

• Schlüsselname

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

• key

  Geben Sie den API-Schlüssel ein.

• API-Schlüsselplatzierung

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

• API-Schlüsselparametername

  Geben Sie den Namen ein, mit dem der API-Aufruf den API-Schlüssel identifiziert, z. B. „apiKey“ oder „X-API-Key“. Diese Informationen finden Sie in der Dokumentation des Webservices, mit dem sich das Modul verbindet.

Alle Status als Fehler auswerten (außer 2xx und 3xx)

Mit dieser Option können Sie die Fehlerbehandlung einrichten.

Weitere Informationen finden Sie unter Fehlerbehandlung.

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-Anfragemethoden.

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.

Texttyp

Der HTTP-Hauptteil sind die Datenbytes, die in einer HTTP-Transaktionsnachricht unmittelbar nach den -Headern übertragen werden, falls welche verwendet werden sollen.

• RAW

  Der Rohtexttyp ist im Allgemeinen für die meisten HTTP-Textkörperanforderungen geeignet, selbst in Situationen, in denen in der Entwicklerdokumentation keine zu sendenden Daten angegeben sind.

  Geben Sie ein Formular zum Analysieren der Daten im Feld Content-Typ an.

  Trotz des ausgewählten Inhaltstyps gibt das Modul Daten in jedem Format ein, das in der Entwicklerdokumentation festgelegt oder erforderlich ist.

• application/x-www-form-urlencoded

  Dieser Hauptteiltyp wird verwendet, um POST-Daten mithilfe von application/x-www-form-urlencoded zu speichern.

  application/x-www-form-urlencoded besteht der Text der an den Server gesendeten HTTP-Nachricht im Wesentlichen aus einer Abfragezeichenfolge. Schlüssel und Werte werden in Schlüssel-Wert-Paaren codiert, die durch & getrennt sind, wobei zwischen Schlüssel und Wert ein = besteht.

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

  Beispiel:

  Beispiel für das daraus resultierende HTTP-Anfrageformat:

  field1=value1&field2=value2

• Multipart/form-data

  Multipart/form-data ist eine mehrteilige HTTP-Anfrage zum Senden von Dateien und Daten. Es wird häufig verwendet, um Dateien auf den Server hochzuladen.

  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 innerhalb des Anfragetexts gesendet werden sollen.

  • -Datei

    Geben Sie den Schlüssel und anschließend die Quelldatei ein, die Sie im Anfrageinhalt senden möchten.

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

Parse response

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

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

Zeitüberschreitung

Angeben des Zeitlimits für Anfragen in Sekunden (1-300). Der Standardwert ist 40 Sekunden.

- Cookies für andere HTTP-Module freigeben

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

Selbstsigniertes Zertifikat

So fügen Sie ein selbstsigniertes Zertifikat hinzu:

1. Klicken Sie auf Extrahieren.

2. Wählen Sie den zu extrahierenden Dateityp aus.

3. Wählen Sie die Datei aus, die das - oder -Zertifikat enthält.

4. Geben Sie das Kennwort für die Datei ein.

5. Klicken Sie auf Speichern, um die Datei zu extrahieren und zum Modul-Setup zurückzukehren.

lehnen Verbindungen ab, die nicht verifizierte (selbstsignierte) Zertifikate verwenden

Aktivieren Sie diese Option, um Verbindungen abzulehnen, die nicht verifizierte TLS-Zertifikate verwenden.

Weiterleitung folgen

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

Alle Weiterleitungen verfolgen

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

Serialisierung mehrerer derselben Abfragezeichenfolgen-Schlüssel als Arrays deaktivieren

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 konvertiert. 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 gegenseitiges TLS in der HTTP-Anfrage zu verwenden.

Weitere Informationen zu gegenseitigen TLS finden Sie unter Verwenden von gegenseitigen TLS in HTTP-Modulen in Adobe Workfront Fusion.