Experience Platform常见问题解答和疑难解答指南

最近更新： 2025年4月4日

创建对象：

  • 开发人员

本文档提供了有关Adobe Experience Platform的常见问题解答，以及有关在任何Experience Platform API中可能遇到的常见错误的高级故障排除指南。 有关单个Experience Platform服务的故障排除指南，请参阅下面的服务故障排除目录。

常见问题解答

以下是有关Adobe Experience Platform的常见问题解答列表。

什么是Experience Platform API？

Experience Platform提供多个RESTful API，它们使用HTTP请求访问Experience Platform资源。 这些服务API每个都会公开多个端点，并允许您执行列出(GET)、查找(GET)、编辑(PUT和/或PATCH)和删除(DELETE)资源的操作。 有关每个服务可用的特定端点和操作的更多信息，请参阅Adobe I/O上的API参考文档。

如何设置API请求的格式？

请求格式因使用的Experience Platform API而异。 要了解如何构建API调用，最好的方法是，按照文档中为您使用的特定Experience Platform服务提供的示例进行操作。

有关格式化API请求的更多信息，请访问Experience Platform API快速入门指南阅读示例API调用部分。

我的组织是什么？

组织是客户的Adobe表示形式。 任何许可的Adobe解决方案均与此客户组织集成。 当组织有权使用Experience Platform时，它可以向开发人员分配访问权限。 组织ID (x-gw-ims-org-id)表示应为其执行API调用的组织，因此需要将其作为所有API请求中的标头。 可以通过Adobe Developer Console找到此ID：在​ 集成 ​选项卡中，导航到任何特定集成的​ 概述 ​部分，以在​ 客户端凭据 ​下查找此ID。 有关如何向Experience Platform进行身份验证的分步说明，请参阅身份验证教程。

在哪里可以找到我的API密钥？

在所有API请求中，都需要API密钥作为标头。 可以通过Adobe Developer Console找到它。 在控制台的​ 集成 ​选项卡上，导航到特定集成的​ 概述 ​部分，您将在​ 客户端凭据 ​下找到密钥。 有关如何向Experience Platform进行身份验证的分步说明，请参阅身份验证教程。

如何获取访问令牌？

所有API调用的Authorization标头中都需要访问令牌。 只要您有权访问组织的集成，就可以使用CURL命令生成这些区段。 访问令牌仅在24小时内有效，之后必须生成新令牌以继续使用API。 有关生成访问令牌的详细信息，请参阅身份验证教程。

如何使用查询参数？

某些Experience Platform API端点接受查询参数以定位特定信息并筛选响应中返回的结果。 查询参数被附加到带有问号(?)的请求路径中，后跟一个或多个使用格式paramName=paramValue的查询参数。 在单个调用中组合多个参数时，必须使用&符号(&)来分隔各个参数。 以下示例演示了文档如何表示使用多个查询参数的请求。

常用查询参数的示例包括：

GET /tenant/schemas?orderby=title
GET /datasets?limit=36&start=10
GET /batches?createdAfter=1559775880000&orderBy=desc:created

有关哪些查询参数适用于特定服务或端点的详细信息，请查看特定于服务的文档。

如何在PATCH请求中指定要更新的JSON字段？

Experience Platform API中的许多PATCH操作都使用JSON指针字符串来指示要更新的JSON属性。 这些通常包含在使用JSON Patch格式的请求负载中。 有关这些技术所需语法的详细信息，请参阅API基础指南。

我可以使用Postman调用Experience Platform API吗？

Postman是一种用于可视化对RESTful API的调用的有用工具。 Experience Platform API快速入门指南包含有关导入Postman收藏集的视频和说明。 此外，还提供了每个服务的Postman收藏集列表。

Experience Platform的系统要求是什么？

根据您使用的是UI还是API，将应用以下系统要求：

对于基于UI的操作：

  • 一种现代化的标准网络浏览器。 虽然建议使用最新版本的Chrome，但也支持Firefox、Internet Explorer和Safari的当前和以前的主要版本。
    • 每次发布新的主要版本时，Experience Platform开始支持最新版本，而不再支持第三个最新版本。
  • 所有浏览器都必须启用Cookie和JavaScript。

对于API和开发人员交互：

  • 要为REST、流和Webhook集成开发的开发环境。