使用Flow Service API建立Shopify基本連線

最後更新： 2026年5月24日

主題：
Sources

建立對象：

{"id":"ff6a42d2-313e-452e-93a6-792e4fad9ff8"}

基礎連線代表來源和Adobe Experience Platform之間的已驗證連線。

閱讀本指南，瞭解如何使用Flow Service API為Shopify來源聯結器建立基礎連線。

快速入門

本指南需要您深入了解下列 Adobe Experience Platform 元件：

Sources：使用來源輕鬆從各種外部系統和平台匯入資料。此功能可讓您整理、標示及擴充傳入的資料，以便使用Experience Platform服務從中取得更多價值。
Sandboxes：沙箱可讓您在Experience Platform執行個體中提供個別的空間，以安全地實驗、測試和開發數位體驗，這樣您就能進行變更，而不會影響您的生產環境。

收集必要的認證

您必須具備有效的Shopify驗證認證，才能建立基礎連線。如需所需認證以及如何取得認證的詳細資訊，請參閱Shopify 來源聯結器概觀。

使用Experience Platform API

如需如何成功呼叫Experience Platform API的詳細資訊，請參閱Experience Platform API快速入門指南。

建立基礎連線

基本連線會保留來源與Experience Platform之間的資訊，包括來源的驗證認證、連線的目前狀態，以及唯一的基本連線ID。基礎連線ID可讓您從來源內部探索及導覽檔案，並識別您要擷取的特定專案，包括其資料型別和格式的資訊。

若要建立基底連線ID，請在提供您的Shopify驗證認證作為要求引數的一部分時，對/connections端點提出POST要求。

API格式

POST /connections

基本驗證

下列要求使用基本驗證建立Shopify的基本連線：

請求

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
屬性	說明
`auth.params.host`	Shopify伺服器的端點。
`auth.params.accessToken`	您的Shopify使用者帳戶的存取權杖。
`connectionSpec.id`	Shopify連線規格識別碼： `4f63aa36-bd48-4e33-bb83-49fbcd11c708`。

回應

成功的回應會傳回新建立的連線，包括其唯一的連線識別碼(id)。在下個教學課程中探索您的資料時，需要此ID。

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

以存取權杖為基礎

下列要求使用基本驗證建立Shopify的基本連線：

請求

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
屬性	說明
`auth.params.host`	Shopify伺服器的端點。
`auth.params.accessToken`	您的Shopify使用者帳戶的存取權杖。
`connectionSpec.id`	Shopify連線規格識別碼： `4f63aa36-bd48-4e33-bb83-49fbcd11c708`。

回應

成功的回應會傳回新建立的連線，包括其唯一的連線識別碼(id)。在下個教學課程中探索您的資料時，需要此ID。

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

後續步驟

依照此教學課程，您已使用Flow Service API建立Shopify基礎連線。您可以在下列教學課程中使用此基本連線ID：

recommendation-more-help

experience-platform-help-sources