Dokumentation Experience Platform Anleitung zu Quell-Connectoren

Erstellen einer generischen REST-API-Basisverbindung mithilfe der Flow Service-API

Letzte Aktualisierung: 4. April 2025

Themen:

Erstellt für:

Entwickler

NOTE

Die Generic REST API-Quelle befindet sich in der Beta-Phase. Weitere Informationen zur Verwendung von Betagekennzeichneten Connectoren finden Sie„Quellen - Übersicht“ .

Eine Basisverbindung stellt die authentifizierte Verbindung zwischen einer Quelle und Adobe Experience Platform dar.

Dieses Tutorial führt Sie durch die Schritte zum Erstellen einer Basisverbindung für Generic REST API mithilfe der Flow Service -API.

Erste Schritte

Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:

Quellen: Experience Platform ermöglicht die Aufnahme von Daten aus verschiedenen Quellen und bietet Ihnen die Möglichkeit, die eingehenden Daten mithilfe von Experience Platform-Services zu strukturieren, zu kennzeichnen und anzureichern.
Sandboxes: Experience Platform bietet virtuelle Sandboxes, die eine einzelne Experience Platform-Instanz in separate virtuelle Umgebungen unterteilen, damit Sie Programme für digitale Erlebnisse besser entwickeln und weiterentwickeln können.

Informationen zum erfolgreichen Aufrufen von Experience Platform-APIs finden Sie im Handbuch unter mit Experience Platform-APIs.

Sammeln erforderlicher Anmeldedaten

Damit Flow Service eine Verbindung mit Generic REST API herstellen kann, müssen Sie gültige Anmeldeinformationen für den Authentifizierungstyp Ihrer Wahl angeben. Generic REST API unterstützt sowohl OAuth 2-Aktualisierungs-Code als auch die Standardauthentifizierung. In den folgenden Tabellen finden Sie Informationen zu den Anmeldeinformationen für die beiden unterstützten Authentifizierungstypen.

OAuth 2-Aktualisierungs-Code

Anmeldedaten	Beschreibung
`host`	Die Host-URL der Quelle, an die Sie Ihre Anfrage stellen. Dieser Wert ist erforderlich und kann nicht mit `requestParameterOverride` umgangen werden.
`authorizationTestUrl`	(Optional) Die URL für den Autorisierungstest wird verwendet, um Anmeldedaten beim Erstellen einer Basisverbindung zu überprüfen. Wenn die Anmeldedaten nicht angegeben sind, werden sie stattdessen während des Erstellungsschritts der Quellverbindung automatisch überprüft.
`clientId`	(Optional) Die mit Ihrem Benutzerkonto verknüpfte Client-ID.
`clientSecret`	(Optional) Das mit Ihrem Benutzerkonto verknüpfte Client-Geheimnis.
`accessToken`	Die primären Authentifizierungsberechtigungen, die für den Zugriff auf Ihr Programm verwendet werden. Das Zugriffs-Token stellt die Autorisierung Ihrer Anwendung für den Zugriff auf bestimmte Aspekte der Daten eines Benutzers dar. Dieser Wert ist erforderlich und kann nicht mit `requestParameterOverride` umgangen werden.
`refreshToken`	(Optional) Ein Token, mit dem ein neues Zugriffstoken generiert wird, wenn das Zugriffstoken abgelaufen ist.
`expirationDate`	(Optional) Ein ausgeblendeter Wert, der das Ablaufdatum Ihres Zugriffstokens definiert.
`accessTokenUrl`	(Optional) Der URL-Endpunkt, der zum Abrufen Ihres Zugriffs-Tokens verwendet wird.
`requestParameterOverride`	(Optional) Eine Eigenschaft, mit der Sie angeben können, welche Berechtigungsparameter überschrieben werden sollen.
`connectionSpec.id`	Die Verbindungsspezifikation gibt die Connector-Eigenschaften einer Quelle zurück, einschließlich der Authentifizierungsspezifikationen für die Erstellung der Basis- und Quellverbindungen. Die Verbindungsspezifikations-ID für Generic REST API ist: `4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62`.

Einfache Authentifizierung

Anmeldedaten	Beschreibung
`host`	Die Host-URL der Quelle, an die Sie Ihre Anfrage stellen.
`username`	Der Benutzername, der Ihrem Benutzerkonto entspricht.
`password`	Das Passwort, das Ihrem Benutzerkonto entspricht.
`connectionSpec.id`	Die Verbindungsspezifikation gibt die Connector-Eigenschaften einer Quelle zurück, einschließlich der Authentifizierungsspezifikationen für die Erstellung der Basis- und Quellverbindungen. Die Verbindungsspezifikations-ID für Generic REST API ist: `4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62`.

Erstellen einer Basisverbindung

Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Experience Platform gespeichert, einschließlich der Authentifizierungsdaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen ID der Basisverbindung. Mit der Kennung der Basisverbindung können Sie Dateien aus Ihrer Quelle heraus analysieren und darin navigieren und die spezifischen Elemente identifizieren, die Sie erfassen möchten, einschließlich Informationen zu ihren Datentypen und Formaten.

Generic REST API unterstützt sowohl einfache Authentifizierung als auch OAuth 2-Aktualisierungs-Code. In den folgenden Beispielen finden Sie Anleitungen zum Authentifizieren mit beiden Authentifizierungstypen.

Erstellen einer Generic REST API-Basisverbindung mit OAuth 2-Aktualisierungs-Code

Um eine Basisverbindungs-ID mit OAuth 2-Aktualisierungs-Code zu erstellen, stellen Sie eine POST-Anfrage an den /connections-Endpunkt, während Sie Ihre OAuth 2-Anmeldeinformationen angeben.

API-Format

POST /connections

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Generic REST API:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}' \
  -H 'Content-Type: application/json' \
  -d '{
      "name": "Generic REST API base connection with OAuth 2 refresh code",
      "description": "Generic REST API base connection with OAuth 2 refresh code",
      "connectionSpec": {
          "id": "4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62",
          "version": "1.0"
      },
      "auth": {
          "specName": "oAuth2RefreshCode",
          "params": {
              "host": "{HOST}",
              "accessToken": "{ACCESS_TOKEN}"
          }
      }
  }'

Eigenschaft

Beschreibung

name

Der Name Ihrer Basisverbindung. Stellen Sie sicher, dass der Name Ihrer Basisverbindung beschreibend ist, da Sie damit Informationen zu Ihrer Basisverbindung nachschlagen können.

description

(Optional) Eine Eigenschaft, die Sie einbeziehen können, um weitere Informationen zu Ihrer Basisverbindung bereitzustellen.

connectionSpec.id

Die Verbindungsspezifikations-ID, die mit Generic REST API verknüpft ist. Diese feste ID lautet: 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62.

auth.specName

Der Authentifizierungstyp, mit dem Sie Ihre Quelle für Experience Platform authentifizieren.

auth.params.host

Die Stamm-URL, mit der die Verbindung zu Ihrer Generic REST API hergestellt wird.

auth.params.accessToken

Das entsprechende Zugriffs-Token, das zum Authentifizieren Ihrer Quelle verwendet wird. Dies ist für die OAuth-basierte Authentifizierung erforderlich.

Antwort

Eine erfolgreiche Antwort gibt die neu erstellte Verbindung zurück, einschließlich ihrer eindeutigen Verbindungskennung (id). Diese ID ist erforderlich, um Ihre Daten im nächsten Tutorial zu untersuchen.

{
  "id": "a5c6b647-e784-4b58-86b6-47e784ab580b",
  "etag": "\"7b01056a-0000-0200-0000-5e8a4f5b0000\""
}

Erstellen einer Generic REST API-Basisverbindung mit einfacher Authentifizierung

Um eine Generic REST API Basisverbindung mit einfacher Authentifizierung zu erstellen, stellen Sie eine POST-Anfrage an den /connections-Endpunkt Flow Service -API und geben Sie dabei Ihre grundlegenden Authentifizierungsdaten an.

API-Format

POST /connections

Anfrage

Die folgende Anfrage erstellt eine Basisverbindung für Generic REST API:

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
      "name": "Generic REST API base connection with basic authentication",
      "description": "Generic REST API base connection with basic authentication",
      "connectionSpec": {
          "id": "4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62",
          "version": "1.0"
      },
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "host": "{HOST}",
              "username": "{USERNAME}",
              "password": "{PASSWORD}"
          }
      }
  }'

Eigenschaft

Beschreibung

name

Der Name Ihrer Basisverbindung. Stellen Sie sicher, dass der Name Ihrer Basisverbindung beschreibend ist, da Sie damit Informationen zu Ihrer Basisverbindung nachschlagen können.

description

(Optional) Eine Eigenschaft, die Sie einbeziehen können, um weitere Informationen zu Ihrer Basisverbindung bereitzustellen.

connectionSpec.id

Die Verbindungsspezifikations-ID, die mit Generic REST API verknüpft ist. Diese feste ID lautet: 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62.

auth.specName

Der Authentifizierungstyp, mit dem Sie Ihre Quelle mit Experience Platform verbinden.

auth.params.host

Die Stamm-URL, mit der die Verbindung zu Ihrer Generic REST API hergestellt wird.

auth.params.username

Der Benutzername, der Ihrer Generic REST API entspricht. Dies ist für die einfache Authentifizierung erforderlich.

auth.params.password

Das Passwort, das Ihrer Generic REST API entspricht. Dies ist für die einfache Authentifizierung erforderlich.

Antwort

Eine erfolgreiche Antwort gibt die neu erstellte Basisverbindung zurück, einschließlich ihrer eindeutigen Verbindungskennung (id). Diese ID ist erforderlich, um die Dateistruktur und Inhalte Ihrer Quelle im nächsten Schritt zu untersuchen.

{
    "id": "9601747c-6874-4c02-bb00-5732a8c43086",
    "etag": "\"3702dabc-0000-0200-0000-615b5b5a0000\""
}

Nächste Schritte

In diesem Tutorial haben Sie eine Generic REST API-Basisverbindung mithilfe der Flow Service-API erstellt. Sie können diese Basisverbindungs-ID in den folgenden Tutorials verwenden:

recommendation-more-help