Die Generic REST API-Quelle befindet sich in der Beta-Phase. Siehe Quellen - Übersicht Weitere Informationen zur Verwendung von Beta-gekennzeichneten Connectoren.
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.
Dieses Handbuch setzt ein Verständnis der folgenden Komponenten von Adobe Experience Platform voraus:
Informationen darüber, wie Sie Platform-APIs erfolgreich aufrufen können, finden Sie im Handbuch unter Erste Schritte mit Platform-APIs.
Zur Flow Service zur Verbindung mit Generic REST APImüssen Sie gültige Anmeldeinformationen für den Authentifizierungstyp Ihrer Wahl angeben. Generic REST API unterstützt sowohl OAuth 2-Aktualisierungscode als auch einfache Authentifizierung. In den folgenden Tabellen finden Sie Informationen zu den Anmeldeinformationen für die beiden unterstützten Authentifizierungstypen.
Anmeldedaten | Beschreibung |
---|---|
host |
Die Host-URL der Quelle, an die Sie Ihre Anfrage richten. Dieser Wert ist erforderlich und kann nicht mithilfe von requestParameterOverride . |
authorizationTestUrl |
(Optional) Die URL für den Autorisierungstest wird verwendet, um Anmeldeinformationen beim Erstellen einer Basisverbindung zu überprüfen. Wenn die Anmeldeinformationen 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äre Authentifizierungsberechtigung für den Zugriff auf Ihre Anwendung. Das Zugriffstoken stellt die Autorisierung Ihrer Anwendung dar, um auf bestimmte Aspekte der Daten eines Benutzers zuzugreifen. Dieser Wert ist erforderlich und kann nicht mithilfe von requestParameterOverride . |
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 Zugriffstokens 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 . |
Anmeldedaten | Beschreibung |
---|---|
host |
Die Host-URL der Quelle, an die Sie Ihre Anfrage richten. |
username |
Der Benutzername, der Ihrem Benutzerkonto entspricht. |
password |
Das Kennwort, 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 . |
Bei einer Basisverbindung werden Informationen zwischen Ihrer Quelle und Platform gespeichert, einschließlich der Authentifizierungsdaten Ihrer Quelle, des aktuellen Verbindungsstatus und Ihrer eindeutigen Kennung 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.
Um eine Basis-Verbindungs-ID mit dem OAuth 2-Aktualisierungscode zu erstellen, stellen Sie eine POST-Anfrage an die /connections
-Endpunkt bei der Bereitstellung Ihrer OAuth 2-Anmeldeinformationen.
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 mit Generic REST API. Diese feste ID lautet: 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62 . |
auth.specName |
Der Authentifizierungstyp, mit dem Sie Ihre Quelle für Platform authentifizieren. |
auth.params.host |
Die Stamm-URL, die für die Verbindung mit Ihrer Generic REST API -Quelle. |
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 der 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\""
}
So erstellen Sie eine Generic REST API Basisverbindung mit einfacher Authentifizierung, stellen Sie eine POST-Anfrage an die /connections
Endpunkt von Flow Service API bei der Bereitstellung Ihrer grundlegenden Authentifizierungsberechtigungen.
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 mit Generic REST API. Diese feste ID lautet: 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62 . |
auth.specName |
Der Authentifizierungstyp, mit dem Sie Ihre Quelle mit Platform verbinden. |
auth.params.host |
Die Stamm-URL, die für die Verbindung mit Ihrer Generic REST API -Quelle. |
auth.params.username |
Der Benutzername, der Ihrer Generic REST API -Quelle. Dies ist für die einfache Authentifizierung erforderlich. |
auth.params.password |
Das Kennwort, das Ihrem Generic REST API -Quelle. 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\""
}
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: