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指南为各个Platform服务提供的示例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服务的故障排除指南，请参阅服务故障排除目录。
有关Platform API中特定端点的更多信息，包括所需的标头和请求正文，请参阅Platform API指南。
平台API指南 api-guides
（数据管理）
(数据科学Workspace)
有关每个服务可用的特定端点和操作的更多信息，请参阅Adobe I/O上的API参考文档。
后续步骤
本文档介绍了所需的标头、可用的指南，并提供了一个示例API调用。 现在您已具有在Adobe Experience Platform上进行API调用所需的标头值，请从Platform API指南表中选择要探索的API端点。
有关常见问题的解答，请参阅平台疑难解答指南。
要设置Postman环境并浏览可用的Postman收藏集，请参阅平台Postman指南。