使用Flow Service API创建常规REST API基本连接

Last update: Tue Jul 16 2024 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

NOTE

Generic REST API源为测试版。有关使用带有Beta标记的连接器的更多信息，请参阅源概述。

基本连接表示源和Adobe Experience Platform之间的已验证连接。

本教程将指导您完成使用Flow Service API为Generic REST API创建基本连接的步骤。

快速入门

本指南要求您对 Adobe Experience Platform 的以下组件有一定了解：

源：Experience Platform允许从各种源摄取数据，同时允许您使用Platform服务来构建、标记和增强传入数据。
沙盒：Experience Platform提供了将单个Platform实例划分为多个单独的虚拟环境的虚拟沙盒，以帮助开发和改进数字体验应用程序。

有关如何成功调用平台API的信息，请参阅平台API快速入门指南。

收集所需的凭据

为了使Flow Service与Generic REST API连接，您必须为您选择的身份验证类型提供有效凭据。 Generic REST API支持OAuth 2刷新代码和基本身份验证。有关两种受支持的身份验证类型的凭据的信息，请参见下表。

OAuth 2刷新代码

凭据

描述

host

您向其发出请求的源的主机URL。此值是必需的，不能使用requestParameterOverride绕过。

authorizationTestUrl

（可选）创建基本连接时，授权测试URL用于验证凭据。如果未提供，则会在源连接创建步骤中自动检查凭据。

clientId

（可选）与您的用户帐户关联的客户端ID。

clientSecret

（可选）与您的用户帐户关联的客户端密钥。

accessToken

用于访问应用程序的主要身份验证凭据。访问令牌表示应用程序的授权，用于访问用户数据的特定方面。此值是必需的，不能使用requestParameterOverride绕过。

refreshToken

（可选）当访问令牌过期时，用于生成新访问令牌的令牌。

expirationDate

（可选）定义访问令牌的过期日期的隐藏值。

accessTokenUrl

（可选）用于获取访问令牌的URL端点。

requestParameterOverride

（可选）一个属性，它允许您指定要覆盖的凭据参数。

connectionSpec.id

连接规范返回源的连接器属性，包括与创建基础连接和源连接相关的验证规范。 Generic REST API的连接规范ID为： 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62。

基本身份验证

凭据

描述

host

您向其发出请求的源的主机URL。

username

与您的用户帐户对应的用户名。

password

与您的用户帐户对应的密码。

connectionSpec.id

连接规范返回源的连接器属性，包括与创建基础连接和源连接相关的验证规范。 Generic REST API的连接规范ID为： 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62。

创建基本连接

基本连接会保留您的源和平台之间的信息，包括源的身份验证凭据、连接的当前状态以及唯一的基本连接ID。基本连接ID允许您浏览和浏览源中的文件，并标识要摄取的特定项目，包括有关其数据类型和格式的信息。

Generic REST API支持基本身份验证和OAuth 2刷新代码。有关如何使用任一身份验证类型进行身份验证的指导，请参阅以下示例。

使用OAuth 2刷新代码创建Generic REST API基本连接

要使用OAuth 2刷新代码创建基本连接ID，请在提供OAuth 2凭据时向/connections端点发出POST请求。

API格式

POST /connections

请求

以下请求为Generic REST API创建基本连接：

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": "Generic REST API base connection with OAuth 2 refresh code",
      "description": "Generic REST API base connection with OAuth 2 refresh code",
      "connectionSpec": {
          "id": "4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62",
          "version": "1.0"
      },
      "auth": {
          "specName": "oAuth2RefreshCode",
          "params": {
              "host": "{HOST}",
              "accessToken": "{ACCESS_TOKEN}"
          }
      }
  }'

属性

描述

name

基础连接的名称。确保基本连接的名称是描述性的，因为您可以使用此名称查找有关基本连接的信息。

description

（可选）可包含的资产，用于提供有关基本连接的更多信息。

connectionSpec.id

与Generic REST API关联的连接规范ID。此固定ID为： 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62。

auth.specName

用于向Platform验证源的身份验证类型。

auth.params.host

用于连接到Generic REST API源的根URL。

auth.params.accessToken

用于对源进行身份验证的相应访问令牌。基于OAuth的身份验证需要此项。

响应

成功的响应返回新创建的连接，包括其唯一连接标识符(id)。在下个教程中，需要此ID才能浏览您的数据。

{
  "id": "a5c6b647-e784-4b58-86b6-47e784ab580b",
  "etag": "\"7b01056a-0000-0200-0000-5e8a4f5b0000\""
}

使用基本身份验证创建Generic REST API基本连接

若要使用基本身份验证创建Generic REST API基本连接，请在提供基本身份验证凭据时向Flow Service API的/connections端点发出POST请求。

API格式

POST /connections

请求

以下请求为Generic REST API创建基本连接：

curl -X POST \
  'https://platform.adobe.io/data/foundation/flowservice/connections' \
  -H 'Authorization: Bearer {ACCESS_TOKEN}' \
  -H 'Content-Type: application/json' \
  -H 'x-api-key: {API_KEY}' \
  -H 'x-gw-ims-org-id: {ORG_ID}' \
  -H 'x-sandbox-name: {SANDBOX_NAME}'
  -d '{
      "name": "Generic REST API base connection with basic authentication",
      "description": "Generic REST API base connection with basic authentication",
      "connectionSpec": {
          "id": "4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62",
          "version": "1.0"
      },
      "auth": {
          "specName": "Basic Authentication",
          "params": {
              "host": "{HOST}",
              "username": "{USERNAME}",
              "password": "{PASSWORD}"
          }
      }
  }'

属性

描述

name

基础连接的名称。确保基本连接的名称是描述性的，因为您可以使用此名称查找有关基本连接的信息。

description

（可选）可包含的资产，用于提供有关基本连接的更多信息。

connectionSpec.id

与Generic REST API关联的连接规范ID。此固定ID为： 4e98f16f-87d6-4ef0-bdc6-7a2b0fe76e62。

auth.specName

您用来将源连接到Platform的身份验证类型。

auth.params.host

用于连接到Generic REST API源的根URL。

auth.params.username

与您的Generic REST API源对应的用户名。这是基本身份验证所必需的。

auth.params.password

与您的Generic REST API源对应的密码。这是基本身份验证所必需的。

响应

成功的响应返回新创建的基本连接，包括其唯一连接标识符(id)。在下一步中浏览源的文件结构和内容时，需要此ID。

{
    "id": "9601747c-6874-4c02-bb00-5732a8c43086",
    "etag": "\"3702dabc-0000-0200-0000-615b5b5a0000\""
}

后续步骤

通过完成本教程，您已使用Flow Service API创建了Generic REST API基本连接。您可以在下列教程中使用此基本连接ID：

recommendation-more-help

337b99bb-92fb-42ae-b6b7-c7042161d089