使用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连接规范ID： `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连接规范ID： `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