版本 | 文章链接 |
---|---|
AEM as a Cloud Service | 单击此处 |
AEM 6.5 | 本文 |
了解对Assets HTTP API中内容片段的支持,这是AEM Headless投放功能的重要组成部分。
此 Assets REST API 允许Adobe Experience Manager的开发人员通过CRUD操作(创建、读取、更新、删除),直接通过HTTP API访问内容(存储在AEM中)。
该API允许您通过向JavaScript前端应用程序提供内容服务,将Adobe Experience Manager作为Headless CMS(内容管理系统)运行。 或者,任何其他可以执行 HTTP 请求并处理 JSON 响应的应用程序。
例如,基于框架或自定义的单页应用程序(SPA)需要通过HTTP API提供的内容,通常采用JSON格式。
同时 AEM核心组件 提供了一个非常全面、灵活且可自定义的API,该API可为此目的的所需读取操作提供服务,并且可以自定义其JSON输出,因此它们确实需要AEM WCM (Web内容管理)专门知识才能实施,因为它们必须托管在基于专用AEM模板的页面中。 并非每个SPA开发组织都可以直接访问此类知识。
这是可以使用资产REST API的时间。 它允许开发人员直接访问资产(例如图像和内容片段),而无需先将资产嵌入页面,然后以序列化JSON格式交付其内容。
无法从Assets REST API自定义JSON输出。
Assets REST API还允许开发人员通过创建新资产、更新或删除现有资产、内容片段和文件夹来修改内容。
资产REST API:
Assets REST API适用于最近的AEM版本的每个现成安装。
Assets REST API提供的 REST-style访问AEM实例中存储的资源。
它使用 /api/assets
端点,并需要资源的路径才能访问它(不带 /content/dam
)。
/content/dam/path/to/asset
/api/assets/path/to/asset
例如,要访问 /content/dam/wknd/en/adventures/cycling-tuscany
,需要请求 /api/assets/wknd/en/adventures/cycling-tuscany.json
访问:
/api/assets
不需要使用 .model
选择器。/content/path/to/page
需要使用 .model
选择器。HTTP 方法决定了要执行的操作:
请求正文和/或 URL 参数可用于配置其中一些操作;例如,定义文件夹或资产应由 POST 请求创建。
支持的请求的确切格式在 API参考 文档。
所有请求都是原子的。
这表示随后(write
)请求无法组合为单个事务,该事务可能会作为单个实体成功或失败。
长宽比 | Assets REST API |
AEM组件 (使用Sling模型的组件) |
支持的用例 | 一般目的。 | 针对单页应用程序(SPA)或任何其他(使用内容)上下文中的使用情况进行了优化。 还可以包含布局信息。 |
支持的操作 | 创建、读取、更新、删除。 根据实体类型执行其他操作。 |
只读. |
访问 | 可以直接访问。 使用 示例路径如下所示: |
需要通过AEM页面上的AEM组件引用。 使用 示例路径如下所示: |
安全性 | 可以使用多个选项。 建议使用OAuth;可与标准设置分开配置。 |
使用AEM标准设置。 |
架构注释 | 写权限通常用于创作实例。 也可以将读取定向到发布实例。 |
由于此方法为只读,因此通常将其用于发布实例。 |
输出 | 基于JSON的SIREN输出:冗长,但功能强大。 允许在内容中导航。 | 基于JSON的专有输出;可通过Sling模型配置。 导航内容结构难以实施(但并不一定不可能)。 |
如果在没有特定身份验证要求的环境中使用Assets REST API,则需要正确配置AEM CORS过滤器。
有关更多信息,请参阅:
在具有特定身份验证要求的环境中,建议使用OAuth。
内容片段是一种特定类型的资产,请参阅 使用内容片段.
有关通过API提供的功能的更多信息,请参阅:
Assets REST API支持通过URL参数执行分页(对于GET请求):
offset
— 要检索的第一个(子)实体的编号limit
— 返回的最大实体数响应将包含分页信息,作为 properties
部分。 此 srn:paging
属性包含(子)实体的总数( total
)、偏移和限制( offset
, limit
)。
分页通常应用于容器实体(即具有演绎版的文件夹或资产),因为它与所请求实体的子项相关。
GET /api/assets.json?offset=2&limit=3
...
"properties": {
...
"srn:paging": {
"total": 7,
"offset": 2,
"limit": 3
}
...
}
...
文件夹充当资源和其他文件夹的容器。 它们反映了AEM内容存储库的结构。
Assets REST API公开对文件夹属性的访问权限;例如,其名称、标题等。 资产将作为文件夹和子文件夹的子实体显示。
根据子资源和文件夹的资源类型,子实体列表可能已经包含定义相应子实体的完整属性集。 或者,对于该子实体列表中的实体,只能公开缩减的属性集。
如果请求资产,则响应将返回其元数据;例如标题、名称以及各个资产架构定义的其他信息。
资产的二进制数据将作为类型的SIREN链接公开 content
.
资源可以具有多个演绎版。 它们通常作为子实体公开,但缩略图演绎版除外,该演绎版以类型的链接公开 thumbnail
( rel="thumbnail"
)。
A 内容片段 是一种特殊类型的资产。 它们可用于访问结构化数据,如文本、数字、日期等。
由于与以下内容存在若干区别 标准 资产(例如图像或音频)时,会应用一些其他规则来处理它们。
内容片段:
不要公开任何二进制数据。
完全包含在JSON输出中(在 properties
属性)。
也被视为原子元素,也就是说,元素和变体作为片段属性的一部分显示,而不是作为链接或子实体显示。 这样可以高效地访问片段的负载。
目前,定义内容片段结构的模型不会通过HTTP API公开。 因此, 消费者 需要了解片段的模型(至少是最低要求) — 尽管可以从有效负载推断出大多数信息;数据类型等。 是定义的一部分。
要创建内容片段,必须提供模型的(内部存储库)路径。
关联内容当前未公开。
根据您使用的是 AEM 创作环境还是发布环境以及您的具体用例,使用情况可能会有所不同。
强烈建议将创建绑定到创作实例(并且当前没有方法复制片段以使用此API发布)。
可以通过这两种方式交付,因为 AEM 仅以 JSON 格式提供请求的内容。
来自 AEM 创作实例的存储和交付应足以满足防火墙背后的媒体库应用程序的需求。
对于实时 Web 交付,建议使用 AEM 发布实例。
AEM实例上的Dispatcher配置可能会阻止对的访问 /api
.
欲知更多详情,请参见 API参考. 具体而言,Adobe Experience Manager Assets API – 内容片段。
使用者式:
GET /{cfParentPath}/{cfName}.json
例如:
http://<host>/api/assets/wknd/en/adventures/cycling-tuscany.json
响应是序列化的 JSON,其内容的结构与内容片段中的一样。引用将作为引用 URL 提供。
可以执行两种类型的读取操作:
使用者式:
POST /{cfParentPath}/{cfName}
正文必须包含要创建的内容片段的 JSON 表示形式,包括应在内容片段元素上设置的任何初始内容。必须设置 cq:model
属性,并且该属性必须指向有效的内容片段模型。如果不这样做,将导致出错。此外,还必须添加一个设置为 application/json
的标头 Content-Type
。
使用者式
PUT /{cfParentPath}/{cfName}
正文必须包含要为给定内容片段更新的内容的 JSON 表示形式。
这可以是内容片段的标题或描述、单个元素或所有元素值和/或元数据。
使用者式:
DELETE /{cfParentPath}/{cfName}
有一些限制:
在相关情况下可以看到以下状态代码:
200 (确定)在以下情况下返回:
GET
PUT
201 (已创建)在以下情况下返回:
POST
404 (未找到)在以下情况下返回:
500 (内部服务器错误)
返回此错误:
下面列出了返回此错误状态以及生成的错误消息(等宽)时的常见情况:
父文件夹不存在(在通过创建内容片段时) POST
)
未提供内容片段模型(缺少cq:model)、无法读取(由于路径无效或权限问题)或没有有效的片段模型:
No content fragment model specified
Cannot create a resource of given model '/foo/bar/qux'
无法创建内容片段(可能是权限问题):
Could not create content fragment
无法更新标题和/或描述:
Could not set value on content fragment
无法设置元数据:
Could not set metadata on content fragment
找不到内容元素或无法更新内容元素
Could not update content element
Could not update fragment data of element
详细错误消息通常以下列方式返回:
{
"class": "core/response",
"properties": {
"path": "/api/assets/foo/bar/qux",
"location": "/api/assets/foo/bar/qux.json",
"parentLocation": "/api/assets/foo/bar.json",
"status.code": 500,
"status.message": "...{error message}.."
}
}
有关详细的API参考,请参阅此处:
有关更多信息,请参阅: