Adobe Experience Manager Assets HTTP API assets-http-api
概述 overview
此 Assets HTTP API允许对数字资产执行创建 — 读取 — 更新 — 删除(CRUD)操作,包括对元数据、演绎版和评论的操作,以及使用的结构化内容 Experience Manager 内容片段。 它在 /api/assets
并且将作为REST API实施。 它包括 支持内容片段.
要访问API,请执行以下操作:
- 打开API服务文档,位于
https://[hostname]:[port]/api.json
. - 请遵循 Assets 服务链接指向
https://[hostname]:[server]/api/assets.json
.
API响应是适用于某些MIME类型的JSON文件,是适用于所有MIME类型的响应代码。 JSON响应是可选的,可能无法用于(例如)PDF文件。 依靠响应代码进行进一步分析或执行操作。
内容片段 content-fragments
A 内容片段 是一种特殊类型的资产。 它可用于访问结构化数据,如文本、数字、日期等。 由于与以下内容存在若干区别 standard
资产(如图像或文档)之外,处理内容片段还适用其他一些规则。
有关更多信息,请参阅 中的内容片段支持 Experience Manager Assets HTTP API.
数据模型 data-model
此 Assets HTTP API公开两个主要元素:文件夹和资源(适用于标准资源)。 此外,它还会为描述内容片段中结构化内容的自定义数据模型显示更详细的元素。 请参阅 内容片段数据模型 以了解详细信息。
文件夹 folders
文件夹与传统文件系统中的目录类似。 文件夹可以只包含资源,也可以只包含文件夹或文件夹和资源。 文件夹具有以下组件:
实体:文件夹的实体是它的子元素,可以是文件夹和资源。
属性:
name
是文件夹的名称。 这与URL路径中没有扩展的最后一个区段相同。title
是文件夹的可选标题,可以显示它而不是其名称。
jcr
前缀 jcr:title
, jcr:description
、和 jcr:language
替换为 dc
前缀。 因此在JSON返回中, dc:title
和 dc:description
包含值 jcr:title
和 jcr:description
、ID名称和ID名称等。链接 文件夹会显示三个链接:
self
:链接到自身。parent
:链接到父文件夹。thumbnail
:(可选)链接到文件夹缩略图图像。
资源 assets
在 Experience Manager 资产包含以下元素:
- 资源的属性和元数据。
- 最初上传的资产的二进制文件。
- 已配置多个演绎版。 这些页面可以是不同大小的图像、不同编码的视频,或者从PDF中提取的页面,或者 Adobe InDesign 文件。
- 可选注释。
有关内容片段中元素的信息,请参阅 Experience Manager Assets HTTP API中的内容片段支持.
在 Experience Manager 文件夹具有以下组件:
- 实体:资产的子项是其演绎版。
- 属性。
- 链接。
可用功能 available-features
此 Assets HTTP API包含以下功能:
检索文件夹列表 retrieve-a-folder-listing
检索现有文件夹及其子实体(子文件夹或资产)的Siren表示形式。
请求: GET /api/assets/myFolder.json
响应代码:响应代码为:
- 200 — 确定 — 成功。
- 404 - NOT FOUND — 文件夹不存在或无法访问。
- 500 — 内部服务器错误 — 如果出现其他错误。
响应:返回的实体的类是资产或文件夹。 包含的实体的属性是每个实体的完整属性集的子集。 要获得实体的完整表示形式,客户端应检索由具有的链接的指向的URL的内容 rel
之 self
.
创建文件夹 create-a-folder
创建 sling
: OrderedFolder
在给定路径上。 如果 *
提供的不是节点名称,而是参数名称,此servlet使用参数名称作为节点名称。 请求接受以下任一情况:
- 新文件夹的警报表示形式
- 一组名称 — 值对,编码为
application/www-form-urlencoded
或multipart
/form
-data
. 这些选项对于直接从HTML表单创建文件夹很有用。
此外,可以将文件夹的属性指定为URL查询参数。
API调用失败,原因是 500
响应代码(如果提供的路径的父节点不存在)。 调用返回响应代码 409
如果文件夹存在。
参数: name
是文件夹名称。
请求
POST /api/assets/myFolder -H"Content-Type: application/json" -d '{"class":"assetFolder","properties":{"title":"My Folder"}}'
POST /api/assets/* -F"name=myfolder" -F"title=My Folder"
响应代码:响应代码为:
- 201 — 已创建 — 成功创建时。
- 409 — 冲突 — 如果文件夹存在。
- 412 - PRECONDITION FAILED — 如果找不到或无法访问根集合。
- 500 — 内部服务器错误 — 如果出现其他错误。
创建资产 create-an-asset
请参阅 资产上传 有关如何创建资产的信息。 无法使用HTTP API创建资源。
更新资产二进制文件 update-asset-binary
请参阅 资产上传 有关如何更新资产二进制文件的信息。 无法使用HTTP API更新资产二进制文件。
更新资源的元数据 update-asset-metadata
更新资源元数据属性。 如果您更新了 dc:
命名空间中,API会更新 jcr
命名空间。 该API不会同步两个命名空间下的属性。
请求: PUT /api/assets/myfolder/myAsset.png -H"Content-Type: application/json" -d '{"class":"asset", "properties":{"dc:title":"My Asset"}}'
响应代码:响应代码为:
- 200 — 确定 — 如果已成功更新资产。
- 404 - NOT FOUND — 如果在提供的URI中找不到或无法访问资产。
- 412 - PRECONDITION FAILED — 如果找不到或无法访问根集合。
- 500 — 内部服务器错误 — 如果出现其他错误。
创建资源演绎版 create-an-asset-rendition
为资源创建演绎版。 如果未提供请求参数名称,则使用文件名作为演绎版名称。
参数:参数为 name
格式副本的名称和 file
作为文件引用。
请求
POST /api/assets/myfolder/myasset.png/renditions/web-rendition -H"Content-Type: image/png" --data-binary "@myRendition.png"
POST /api/assets/myfolder/myasset.png/renditions/* -F"name=web-rendition" -F"file=@myRendition.png"
响应代码
- 201 - CREATED — 如果已成功创建呈现版本。
- 404 - NOT FOUND — 如果在提供的URI中找不到或无法访问资产。
- 412 - PRECONDITION FAILED — 如果找不到或无法访问根集合。
- 500 — 内部服务器错误 — 如果出现其他错误。
更新资源演绎版 update-an-asset-rendition
更新会分别用新的二进制数据替换资产演绎版。
请求: PUT /api/assets/myfolder/myasset.png/renditions/myRendition.png -H"Content-Type: image/png" --data-binary @myRendition.png
响应代码:响应代码为:
- 200 - OK — 如果已成功更新演绎版。
- 404 - NOT FOUND — 如果在提供的URI中找不到或无法访问资产。
- 412 - PRECONDITION FAILED — 如果找不到或无法访问根集合。
- 500 — 内部服务器错误 — 如果出现其他错误。
在资产上添加评论 create-an-asset-comment
参数:参数为 message
注释和的消息正文 annotationData
JSON格式的注释数据。
请求: POST /api/assets/myfolder/myasset.png/comments/* -F"message=Hello World." -F"annotationData={}"
响应代码:响应代码为:
- 201 - CREATED — 如果评论已成功创建。
- 404 - NOT FOUND — 如果在提供的URI中找不到或无法访问资产。
- 412 - PRECONDITION FAILED — 如果找不到或无法访问根集合。
- 500 — 内部服务器错误 — 如果出现其他错误。
复制文件夹或资源 copy-a-folder-or-asset
将提供的路径中可用的文件夹或资产复制到新目标。
请求标头:参数为:
X-Destination
- API解决方案范围内的新目标URI,可将资源复制到其中。X-Depth
— 或infinity
或0
. 使用0
仅复制资源及其属性,而不复制其子项。X-Overwrite
— 使用F
以防止覆盖现有目标上的资产。
请求: COPY /api/assets/myFolder -H"X-Destination: /api/assets/myFolder-copy"
响应代码:响应代码为:
- 201 - CREATED — 文件夹/资产是否已复制到不存在的目标。
- 204 — 无内容 — 如果将文件夹/资产复制到现有目标。
- 412 - PRECONDITION失败 — 如果缺少请求标头。
- 500 — 内部服务器错误 — 如果出现其他错误。
移动文件夹或资源 move-a-folder-or-asset
将给定路径下的文件夹或资源移动到新目标。
请求标头:参数为:
X-Destination
- API解决方案范围内的新目标URI,可将资源复制到其中。X-Depth
— 或infinity
或0
. 使用0
仅复制资源及其属性,而不复制其子项。X-Overwrite
— 使用T
强制删除现有资源或F
以防止覆盖现有资源。
请求: MOVE /api/assets/myFolder -H"X-Destination: /api/assets/myFolder-moved"
响应代码:响应代码为:
- 201 - CREATED — 文件夹/资产是否已复制到不存在的目标。
- 204 — 无内容 — 如果将文件夹/资产复制到现有目标。
- 412 - PRECONDITION失败 — 如果缺少请求标头。
- 500 — 内部服务器错误 — 如果出现其他错误。
删除文件夹、资源或演绎版 delete-a-folder-asset-or-rendition
在提供的路径中删除资源(-tree)。
请求
DELETE /api/assets/myFolder
DELETE /api/assets/myFolder/myAsset.png
DELETE /api/assets/myFolder/myAsset.png/renditions/original
响应代码:响应代码为:
- 200 - OK — 已成功删除文件夹。
- 412 - PRECONDITION FAILED — 如果找不到或无法访问根集合。
- 500 — 内部服务器错误 — 如果出现其他错误。
提示、最佳实践和限制 tips-limitations
-
在 关闭时间,资产及其演绎版不可通过 Assets Web界面和通过HTTP API。 如果 准时 是未来或 关闭时间 是过去的。
-
资源HTTP API不返回完整的元数据。 命名空间是硬编码的,并且只返回这些命名空间。 有关完整的元数据,请参阅资源路径
/jcr_content/metadata.json
. -
使用API更新时,文件夹或资产的某些属性会映射到不同的前缀。 此
jcr
前缀jcr:title
,jcr:description
、和jcr:language
替换为dc
前缀。 因此在JSON返回中,dc:title
和dc:description
包含值jcr:title
和jcr:description
、ID名称和ID名称等。
另请参阅