Schema Registry API指南

此 Schema Registry 用于访问Adobe Experience Platform中的架构库,提供一个用户界面和RESTful API,可从其中访问所有可用的库资源。

架构注册表API提供了多个端点,允许您以编程方式管理Platform中可供您使用的所有架构和相关体验数据模型(XDM)资源。 这包括Adobe定义的那些规则, Experience Platform 合作伙伴以及您使用应用程序的供应商。

这些端点概述如下。 有关详细信息,请参阅各个端点指南,并参阅 快速入门指南 有关所需标头的重要信息,请阅读示例API调用等。

IMPORTANT
XDM使用JSON架构格式来描述和验证所摄取的客户体验数据的结构。 在使用架构注册表API之前,强烈建议您查看 官方JSON架构文档 以更好地了解这一基础技术。

要查看所有可用的端点和CRUD操作,请访问 架构注册表API参考.

架构

XDM架构表示并验证引入到Platform中的数据结构和格式。 架构由一个类以及零个或多个架构字段组组成。 您可以使用创建、查看、编辑和删除架构 /schemas 端点。 要了解如何使用此端点,请参阅 架构端点指南.

有关如何在Schema Registry API中手动创建完整模式(包括创建和添加字段组和数据类型)的分步指南,请参阅 API架构创建教程.

如果您正在摄取CSV数据,请参阅 CSV到架构的转换.

行为

行为定义架构描述的数据的性质。 每个XDM类都必须引用一个特定行为,使用该类的所有架构都将继承该行为。 请参阅 行为端点指南 以了解如何查看API中的可用行为。

类定义了基于该类的所有架构都必须包含的公共属性的基本结构,并确定哪些字段组适合在这些架构中使用。 每个类都必须与现有行为关联。 请参阅 类端点指南 有关在API中使用类的详细信息。

字段组

字段组是可重复使用的组件,它们定义表示特定概念的一个或多个字段,例如个人、邮寄地址或Web浏览器环境。 字段组旨在作为实现兼容类的架构的一部分包含,具体取决于它们表示的数据的行为(记录或时间序列)。 请参阅 字段组端点指南 以了解如何在API中使用字段组。

数据类型

数据类型在类或字段组中用作引用类型字段的方式与基本文本字段相同,主要区别在于数据类型可以定义多个子字段。 虽然与字段组类似,它们允许一致地使用多字段结构,但数据类型更加灵活,因为它们可以包含在架构结构中的任意位置,而字段组只能在根级别添加。 请参阅 数据类型端点指南 有关在API中使用数据类型的更多信息。

NOTE
如果字段被定义为特定数据类型,则无法在另一个架构中创建具有不同数据类型的相同字段。 此限制适用于您组织的租户。

描述符

描述符是分配给架构中特定字段的元数据集,提供各种上下文详细信息,包括这些字段(以及架构本身)如何与其他架构相关联。 每个架构可以应用一个或多个描述符实体,并且有多种不同的描述符类型用于不同的目的。 请参阅 描述符端点指南 有关在API中使用描述符的更多信息,以及不同描述符类型及其用例的概述。

联合

虽然Platform允许您针对特定用例编写架构,但它还允许您编写属于特定类的架构的“联合”。 合并架构将共享相同类的所有架构的字段聚合到单个表示中。 启用架构以用于 Real-time Customer Profile,则该架构将包含在其特定类的合并中。 因此,不能直接编辑合并架构,并且只能受包含或排除用于配置文件中的架构的影响。

要了解如何在架构注册表API中查看联合,请参阅 联合端点指南.

CSV到架构的转换 csv-to-schema

您可以使用CSV文件作为模板自动生成XDM架构,从而创建模板以批量导入架构字段并减少手动API或用户界面工作。

请参阅 《 CSV到架构转换端点指南》 以了解更多信息。

NOTE
您还可以使用UI来 使用人工智能生成的推荐将CSV映射到架构 (当前为测试版)。

导出 export

架构注册API允许您在沙盒和组织之间传输和共享XDM资源。 对于任何架构、字段组或数据类型,可生成包含资源结构和任何依赖资源的导出有效负载。 然后,此有效负载可用于将资源导入目标沙盒和组织。

请参阅 导出端点指南 有关如何为现有XDM资源创建导出有效负荷的更多信息。

导入

如果您使用 导出CSV到架构的转换 端点要创建导出有效负载,您可以将该有效负载发送到目标组织和沙盒以导入指定的资源。

请参阅 导入端点指南 有关如何从导出有效负载生成XDM资源的更多信息。

示例数据

您可以为架构库中的任何指定架构生成示例数据。 然后,返回的响应对象可用作数据摄取的源。

请参阅 示例数据端点指南 有关使用此端点的更多信息。

审核日志

架构注册表维护在不同更新之间对资源(类、字段组、数据类型或架构)发生的所有更改的日志。 您可以通过提供特定资源的日志来检索该资源 $idmeta:altId 在此端点的GET请求路径中。

请参阅 审核日志端点指南 有关使用此端点的更多信息。

后续步骤

要开始使用架构注册表API进行调用,请阅读 快速入门指南 然后选择其中一个端点指南以了解如何使用特定端点。

recommendation-more-help
62e9ffd9-1c74-4cef-8f47-0d00af32fc07