[Beta 版]{class="badge informative"}
自助源快速入门(Streaming SDK)
NOTE
自助源流SDK处于测试阶段。 有关使用测试版标记源的更多信息,请阅读源概述。
自助式源(流SDK)允许您集成自己的源,以将流数据引入Adobe Experience Platform。 本文档介绍了在尝试调用Flow Service API之前需要了解的核心概念。
高级流程
下面概述了在Experience Platform中配置源的分步流程:
集成
- 为流SDK创建新的连接规范。
- 使用新的连接规范ID更新流流规范。
- 测试并提交您的流源。
文档
- 要开始记录您的源,请阅读有关创建自助源文档的概述。
- 有关如何使用GitHub创建文档的步骤,请阅读有关使用GitHub Web界面的指南。
- 阅读有关使用文本编辑器的指南,了解如何使用本地计算机创建文档的步骤。
- 使用流SDK API文档模板在API中记录您的源。
- 使用流SDK UI文档模板在UI中记录您的源。
您还可以下载以下文档模板:
先决条件
IMPORTANT
要发送更新,您与Experience Platform集成的源必须能够支持端点可以订阅的webhook。
要使用自助源(流SDK),您必须确保您有权访问配置了Adobe Experience Platform源的沙盒组织。
此外,您还需要实际了解Adobe Experience Platform的以下组件:
正在读取示例 API 调用
自助源(流SDK)和Flow Service API文档提供了示例API调用,以演示如何格式化请求。 这些包括路径、必需的标头和格式正确的请求负载。还提供了在 API 响应中返回的示例 JSON。有关示例API调用文档中使用的约定的信息,请参阅Experience Platform疑难解答指南中有关如何读取示例API调用的部分。
收集所需标头的值
要调用Platform API,必须先完成身份验证教程。 完成身份验证教程会提供所有 Experience Platform API 调用中每个所需标头的值,如下所示:
Authorization: Bearer {ACCESS_TOKEN}
x-api-key: {API_KEY}
x-gw-ims-org-id: {ORG_ID}
Platform中的所有资源(包括属于Flow Service的资源)都被隔离到特定的虚拟沙盒中。 所有对Platform API的请求都需要一个标头,用于指定将在其中执行操作的沙盒的名称:
x-sandbox-name: {SANDBOX_NAME}
NOTE
有关Platform中沙盒的更多信息,请参阅沙盒文档。
包含负载 (POST、PUT、PATCH) 的所有请求都需要额外的标头:
Content-Type: application/json
337b99bb-92fb-42ae-b6b7-c7042161d089