Erstellen einer Shopify-Basisverbindung mithilfe der Flow Service-API

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

Lesen Sie dieses Handbuch, um zu erfahren, wie Sie eine Basisverbindung für den Shopify-Quell-Connector mithilfe der Flow Service API erstellen.

Erste Schritte

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

Sammeln erforderlicher Anmeldedaten

Sie müssen über gültige Shopify-Authentifizierungsdaten verfügen, um eine Basisverbindung zu erstellen. Einzelheiten zu den erforderlichen Anmeldeinformationen und deren Abruf finden Sie unter Shopify Quell-Connector - Übersicht.

Verwenden von Experience Platform-APIs

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

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.

Um eine Basisverbindungs-ID zu erstellen, stellen Sie eine POST-Anfrage an den Endpunkt /connections und geben Sie dabei Ihre Shopify-Authentifizierungs-Anmeldedaten als Teil der Anfrageparameter an.

API-Format

POST /connections

Einfache Authentifizierung

Die folgende Anfrage erstellt eine Basisverbindung für Shopify mit einfacher Authentifizierung:

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": "Shopify source",
      "description": "Shopify source",
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "host": "{HOST}",
              "accessToken": "{ACCESS_TOKEN}"
          }
      },
      "connectionSpec": {
          "id": "4f63aa36-bd48-4e33-bb83-49fbcd11c708",
          "version": "1.0"
      }
  }

{
    "id": "582f4f8d-71e9-4a5c-a164-9d2056318d6c",
    "etag": "\"d600d3ae-0000-0200-0000-5fa99a3d0000\""
}

Basierend auf Zugriffstoken

Die folgende Anfrage erstellt eine Basisverbindung für Shopify mit einfacher Authentifizierung:

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": "Create shopify v2 Test Connection",
    "description": "Connection creation for Shopify",
    "auth": {
      "specName": "Access Token Based",
      "params": {
        "host": "{HOST}",
        "accessToken": "{ACCESS_TOKEN}"
      }
    },
    "connectionSpec": {
      "id": "4f63aa36-bd48-4e33-bb83-49fbcd11c708",
      "version": "1.0"
    }
}'

{
    "id": "92a00150-f3cc-4283-8fc4-6232725bcf33",
    "etag": "\"bb04d1f7-0000-0200-0000-69807e830000\""
}

Nächste Schritte

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