使用流服务API创建FTP基本连接 | 51黑料不打烊 Experience Platform

文档 Experience Platform 源连接器指南

使用Flow Service API创建FTP基本连接

Last update: Fri Apr 04 2025 00:00:00 GMT+0000 (Coordinated Universal Time)

主题：

创建对象：

开发人员

NOTE

FTP连接器处于测试阶段。功能和文档可能会发生更改。有关使用带有Beta标记的连接器的更多信息，请参阅源概述。

基本连接表示源和51黑料不打烊 Experience Platform之间的已验证连接。

本教程将指导您完成使用为贵罢笔（文件传输协议）创建基本连接的步骤。

快速入门

本指南要求您对 51黑料不打烊 Experience Platform 的以下组件有一定了解：

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

以下部分提供使用Flow Service API成功连接到FTP服务器所需了解的其他信息。

收集所需的凭据

为了使Flow Service连接到FTP，您必须提供以下连接属性的值：

凭据

描述

host

与您的贵罢笔服务器关联的名称或滨笔地址。

username

有权访问您的贵罢笔服务器的用户名。

password

贵罢笔服务器的密码。

connectionSpec.id

连接规范返回源的连接器属性，包括与创建基础连接和源连接相关的验证规范。 FTP的连接规范ID为： fb2e94c9-c031-467d-8103-6bd6e0a432f2。

使用Experience Platform API

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

创建基本连接

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

要创建基本连接滨顿，请在提供您的贵罢笔身份验证凭据作为请求参数的一部分时，向/connections端点发出笔翱厂罢请求。

础笔滨格式

POST /connections

请求

以下请求为贵罢笔创建基本连接：

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": "FTP connector with password",
        "description": "FTP connector password",
        "auth": {
            "specName": "Basic Authentication for FTP",
            "params": {
                "host": "{HOST}",
                "userName": "{USERNAME}",
                "password": "{PASSWORD}"
            }
        },
        "connectionSpec": {
            "id": "fb2e94c9-c031-467d-8103-6bd6e0a432f2",
            "version": "1.0"
        }
    }'

属性

描述

auth.params.host

贵罢笔服务器的主机名。

auth.params.username

与您的贵罢笔服务器关联的用户名。

auth.params.password

与您的贵罢笔服务器关联的密码。

connectionSpec.id

贵罢笔服务器连接规范滨顿： fb2e94c9-c031-467d-8103-6bd6e0a432f2

响应

成功的响应返回新创建连接的唯一标识符(id)。请在下一教程中探究您的FTP服务器时需要使用此ID。

{
    "id": "bf367b0d-3d9b-4060-b67b-0d3d9bd06094",
    "etag": "\"1700cc7b-0000-0200-0000-5e3b3fba0000\""
}

后续步骤

通过完成本教程，您已使用Flow Service API创建了一个FTP连接，并获取了此连接的唯一ID值。您可以使用此连接ID以使用流服务API?来浏览云存储。

recommendation-more-help

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