Een Shopify basisverbinding maken met de Flow Service API

Een basisverbinding vertegenwoordigt de geverifieerde verbinding tussen een bron en Adobe Experience Platform.

Lees deze gids om te leren hoe te om een basisverbinding voor de Shopify bronschakelaar tot stand te brengen gebruikend Flow Service API ​.

Aan de slag

Deze handleiding vereist een goed begrip van de volgende onderdelen van Adobe Experience Platform:

  • Sources : Gebruik Bronnen om gegevens van verschillende externe systemen en platforms eenvoudig in te voeren. Met deze functie kunt u inkomende gegevens organiseren, labelen en verrijken, zodat u er meer waarde uit kunt halen met Experience Platform-services.
  • Sandboxes : Met sandboxen kunt u veilig digitale ervaringen experimenteren, testen en ontwikkelen door aparte ruimten binnen uw Experience Platform-instantie te creëren. Zo kunt u wijzigingen aanbrengen zonder dat dit van invloed is op uw productieomgeving.

Vereiste referenties verzamelen

U moet geldige Shopify verificatiereferenties hebben om een basisverbinding te maken. Voor details op de vereiste geloofsbrieven en hoe te om hen te verkrijgen, verwijs naar het Shopify overzicht van de bronschakelaar ​.

Experience Platform API’s gebruiken

Voor informatie over hoe te om vraag aan Experience Platform APIs met succes te maken, zie de gids op ​ begonnen wordt met Experience Platform APIs ​.

Een basisverbinding maken

Een basisverbinding behoudt informatie tussen uw bron en Experience Platform, met inbegrip van de verificatiereferenties van uw bron, de huidige status van de verbinding, en uw unieke identiteitskaart van de basisverbinding. Met de ID van de basisverbinding kunt u bestanden verkennen en door bestanden navigeren vanuit uw bron en kunt u de specifieke items identificeren die u wilt opnemen, inclusief informatie over hun gegevenstypen en indelingen.

Als u een basis-verbindings-id wilt maken, vraagt u een POST-aanvraag naar het /connections -eindpunt en geeft u de Shopify -verificatiegegevens op als onderdeel van de aanvraagparameters.

API formaat

POST /connections

Basisverificatie

Met de volgende aanvraag wordt een basisverbinding voor Shopify gemaakt met behulp van basisverificatie:

Verzoek
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
Eigenschap Beschrijving
auth.params.host Het eindpunt van de Shopify server.
auth.params.accessToken Het toegangstoken voor uw Shopify gebruikersaccount.
connectionSpec.id De Shopify connection specification-id: 4f63aa36-bd48-4e33-bb83-49fbcd11c708 .
Antwoord

Een succesvolle reactie keert de pas gecreëerde verbinding, met inbegrip van zijn unieke verbindings herkenningsteken (id) terug. Deze id is vereist om uw gegevens te kunnen bekijken in de volgende zelfstudie.

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

Op basis van toegangstoken

Met de volgende aanvraag wordt een basisverbinding voor Shopify gemaakt met behulp van basisverificatie:

Verzoek
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
Eigenschap Beschrijving
auth.params.host Het eindpunt van de Shopify server.
auth.params.accessToken Het toegangstoken voor uw Shopify gebruikersaccount.
connectionSpec.id De Shopify connection specification-id: 4f63aa36-bd48-4e33-bb83-49fbcd11c708 .
Antwoord

Een succesvolle reactie keert de pas gecreëerde verbinding, met inbegrip van zijn unieke verbindings herkenningsteken (id) terug. Deze id is vereist om uw gegevens te kunnen bekijken in de volgende zelfstudie.

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

Volgende stappen

Aan de hand van deze zelfstudie hebt u een Shopify basisverbinding gemaakt met de Flow Service API. U kunt deze basis verbindings-id in de volgende zelfstudies gebruiken:

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