Skapa en Shopify-basanslutning med API:t Flow Service

En basanslutning representerar den autentiserade anslutningen mellan en källa och Adobe Experience Platform.

Läs den här vägledningen när du vill lära dig hur du skapar en basanslutning för Shopify-källkopplingen med Flow Service API.

Komma igång

Handboken kräver en fungerande förståelse av följande komponenter i Adobe Experience Platform:

  • Sources: Använd Källor för att enkelt hämta in data från olika externa system och plattformar. Med den här funktionen kan du ordna, märka och förbättra dina inkommande data så att du kan få ut mer av dem med hjälp av Experience Platform tjänster.
  • Sandboxes: Med sandlådor kan du tryggt experimentera, testa och utveckla digitala upplevelser genom att tillhandahålla separata utrymmen i Experience Platform-instansen, så att du kan göra ändringar utan att påverka produktionsmiljön.

Samla in nödvändiga inloggningsuppgifter

Du måste ha giltiga autentiseringsuppgifter för Shopify för att skapa en basanslutning. Mer information om nödvändiga autentiseringsuppgifter och hur du hämtar dem finns i Shopify källanslutningsöversikten.

Använda Experience Platform API:er

Information om hur du kan anropa Experience Platform API:er finns i guiden Komma igång med Experience Platform API:er.

Skapa en basanslutning

En basanslutning bevarar information mellan källan och Experience Platform, inklusive autentiseringsuppgifter för källan, anslutningens aktuella tillstånd och ditt unika basanslutnings-ID. Med det grundläggande anslutnings-ID:t kan du utforska och navigera bland filer inifrån källan och identifiera de specifika objekt som du vill importera, inklusive information om deras datatyper och format.

Om du vill skapa ett basanslutnings-ID skickar du en POST-begäran till /connections-slutpunkten och anger dina Shopify-autentiseringsuppgifter som en del av parametrarna för begäran.

API-format

POST /connections

Grundläggande autentisering

Följande begäran skapar en basanslutning för Shopify med grundläggande autentisering:

Begäran
code language-shell
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"
      }
  }
table 0-row-2 1-row-2 2-row-2 3-row-2
Egenskap Beskrivning
auth.params.host Slutpunkten för servern Shopify.
auth.params.accessToken Åtkomsttoken för ditt Shopify-användarkonto.
connectionSpec.id Anslutningsspecifikations-ID för Shopify: 4f63aa36-bd48-4e33-bb83-49fbcd11c708.
Svar

Ett svar returnerar den nyligen skapade anslutningen, inklusive dess unika anslutnings-ID (id). Detta ID krävs för att utforska dina data i nästa självstudiekurs.

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

Åtkomsttokenbaserad

Följande begäran skapar en basanslutning för Shopify med grundläggande autentisering:

Begäran
code language-shell
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"
    }
}'
table 0-row-2 1-row-2 2-row-2 3-row-2
Egenskap Beskrivning
auth.params.host Slutpunkten för servern Shopify.
auth.params.accessToken Åtkomsttoken för ditt Shopify-användarkonto.
connectionSpec.id Anslutningsspecifikations-ID för Shopify: 4f63aa36-bd48-4e33-bb83-49fbcd11c708.
Svar

Ett svar returnerar den nyligen skapade anslutningen, inklusive dess unika anslutnings-ID (id). Detta ID krävs för att utforska dina data i nästa självstudiekurs.

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

Nästa steg

Genom att följa den här självstudiekursen har du skapat en Shopify-basanslutning med API:t Flow Service. Du kan använda detta grundläggande anslutnings-ID i följande självstudier:

recommendation-more-help
experience-platform-help-sources