数据摄取API快速入门 getting-started

使用数据摄取API端点,您可以执行基本的CRUD操作,以便在Adobe Experience Platform中摄取数据。

使用API指南需要实际了解与数据处理有关的多个Adobe Experience Platform服务。 在使用数据摄取API之前,请查看以下服务的文档:

  • 批量摄取:允许您将数据作为批处理文件摄取到Adobe Experience Platform中。
  • Real-Time Customer Profile:根据来自多个源的汇总数据,实时提供统一的客户个人资料。
  • Experience Data Model (XDM): Platform用于组织客户体验数据的标准化框架。
  • Sandboxes: Experience Platform提供了将单个Platform实例划分为多个单独的虚拟环境的虚拟沙箱,以帮助开发和改进数字体验应用程序。

以下部分提供了成功调用Profile API端点需要了解的其他信息。

正在读取示例 API 调用

数据摄取API文档提供了示例API调用,以演示如何正确设置请求的格式。 这些包括路径、必需的标头和格式正确的请求负载。还提供了在 API 响应中返回的示例 JSON。有关示例API调用文档中使用的约定的信息,请参阅Experience Platform疑难解答指南中有关如何读取示例API调用的部分。

必需的标头

API文档还要求您完成身份验证教程,才能成功调用Platform端点。 完成身份验证教程将提供Experience Platform API调用中每个所需标头的值,如下所示:

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {ORG_ID}

所有在请求正文中具有有效负载的请求(如POST、PUT和PATCH调用)都必须包含Content-Type标头。 调用参数中提供了特定于每个调用的接受值。

Experience Platform中的所有资源都被隔离到特定的虚拟沙盒中。 对Platform API的请求需要一个标头,该标头指定将在其中执行操作的沙盒的名称:

  • x-sandbox-name: {SANDBOX_NAME}

有关Platform中沙盒的更多信息,请参阅沙盒概述文档

recommendation-more-help
2ee14710-6ba4-4feb-9f79-0aad73102a9a