Adobe Experience Platform API快速入门
Adobe Experience Platform是根据“API优先”的理念开发的。 使用Platform API，您可以以编程方式对数据执行基本CRUD（创建、读取、更新、删除）操作，例如配置计算属性、访问数据/实体、导出数据、删除不需要的数据或批次等。
每个Experience Platform服务的API都共享同一组身份验证标头，并对其CRUD操作使用类似的语法。 以下指南概述了开始使用Platform API的必要步骤。
身份验证和标头
要成功调用Platform端点，您需要完成 身份验证教程. 完成身份验证教程将提供Experience PlatformAPI调用中每个所需标头的值，如下所示：
Authorization: Bearer {ACCESS_TOKEN}x-api-key: {API_KEY}x-gw-ims-org-id: {ORG_ID}
沙盒标头
Experience Platform中的所有资源都被隔离到特定的虚拟沙盒中。 对Platform API的请求需要一个标头，该标头指定将在其中执行操作的沙盒的名称：
x-sandbox-name: {SANDBOX_NAME}
有关Platform中沙盒的更多信息，请参阅 沙盒概述文档.
内容类型标头
所有在请求正文中具有有效负载的请求(例如POST、PUT和PATCH调用)都必须包含 Content-Type 标题。 接受的值特定于每个API端点。 如果 Content-Type 端点需要值，其值将显示在提供的示例API请求中。 适用于各个平台服务的API指南.
Experience PlatformAPI基础知识
Adobe Experience Platform API采用多种底层技术和语法，这些技术和语法对于有效管理Platform资源非常重要，需要了解。
要详细了解Platform使用的底层API技术，包括示例JSON模式对象，请访问 Experience PlatformAPI基础知识 指南。
Experience PlatformAPI的Postman收藏集
Postman是API开发的协作平台，允许您使用预设变量设置环境、共享API收藏集、简化CRUD请求等。 大多数Platform API服务都具有Postman集合，这些集合可用于协助进行API调用。
要了解有关Postman的更多信息（包括如何设置环境、可用收藏集列表以及如何导入收藏集），请访问 Platform Postman文档.
正在读取示例 API 调用 sample-api
请求格式因所使用的平台API而异。 了解如何构建API调用结构的最佳方法是，按照与所使用的特定Platform服务的文档提供的示例进行操作。
的文档 Experience Platform 以两种不同的方式显示API调用示例。 首先，调用会显示在其 API格式，一种模板表示形式，仅显示操作(GET、POST、PUT、PATCH、DELETE)和正在使用的端点(例如， /global/classes)。 某些模板还显示变量的位置，以帮助说明应如何制定调用，例如 GET /{VARIABLE}/classes/{ANOTHER_VARIABLE}.
然后，调用将作为中的cURL命令显示 请求，包括成功与API交互所需的必要标头和完整“基本路径”。 基本路径应预先附加到所有端点。 例如，前面提到的 /global/classes 终结点变为 https://platform.adobe.io/data/foundation/schemaregistry/global/classes. 您将在整个文档中看到API格式/请求模式，并在自行调用Platform API时，应使用示例请求中显示的完整路径。
示例API请求
以下是一个API请求示例，用于演示将在文档中遇到的格式。
API格式
API格式显示了正在使用的操作(GET)和端点。 变量由大括号指示(在本例中， {CONTAINER_ID})。
GET /{CONTAINER_ID}/classes
请求
在此示例请求中，API格式的变量在请求路径中给定实际值。 此外，所有必需的标头都会显示为标头值示例或变量，其中应包含敏感信息（例如安全令牌和访问ID）。
curl -X GET \
https://platform.adobe.io/data/foundation/schemaregistry/global/classes \
-H 'Accept: application/vnd.adobe.xed-id+json' \
-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}'
响应
响应将基于发送的请求说明在成功调用API后您会收到什么内容。 有时，响应会截断空格，这意味着您可能会看到示例中显示的详细信息或附加信息。
{
"results": [
{
"title": "XDM ExperienceEvent",
"$id": "https://ns.adobe.com/xdm/context/experienceevent",
"meta:altId": "_xdm.context.experienceevent",
"version": "1"
},
{
"title": "XDM Individual Profile",
"$id": "https://ns.adobe.com/xdm/context/profile",
"meta:altId": "_xdm.context.profile",
"version": "1"
}
],
"_links": {}
}
错误消息
此 平台疑难解答指南 提供了在使用任何Experience Platform服务时可能遇到的错误列表。
有关各平台服务的故障排除指南，请参阅 服务疑难解答目录.
有关Platform API中特定端点的更多信息，包括所需的标头和请求正文，请参阅 平台API指南.
平台API指南 api-guides
（数据管理）
（数据科学工作区）
欲知关于每项服务可用的特定端点和操作的更多信息，请参见 API参考文档 Adobe I/O时。
后续步骤
本文档介绍了所需的标头、可用的指南，并提供了一个示例API调用。 现在，您已在Adobe Experience Platform上进行API调用所需的标头值，请从中选择要探索的API端点 平台API指南表.
有关常见问题的解答，请参阅 平台疑难解答指南.
要设置Postman环境并探索可用的Postman收藏集，请参阅 Platform Postman指南.