搜索Assets API search-assets-api
可以使用投放URL搜索Experience Manager资源存储库中可用的所有批准的资源,然后将其传递到集成的下游应用程序。
从Experience Manager存储库中搜索正确的已批准资源是使用投放URL交付资源的第一步。 对搜索请求的响应包括对应于满足搜索条件的资产的JSON文档数组。 每个JSON文档都使用id
字段进行标识,该字段用于构成资产投放请求。
您可以在Search Assets API请求中定义属性以启用以下功能:
-
全文搜索:使用
match
查询定义要搜索的文本。 您还可以使用match
查询中的运算符来筛选结果。 -
应用筛选器:使用
term
查询通过定义key
和一个或多个值进一步筛选结果。key
标识其值必须匹配的字段,value
表示要匹配的对象。 同样,您可以使用range
查询通过“大于(gt)”、“大于或等于(gte)”、“小于(lt)”和“小于或等于(lte)”属性来定义字段的范围。 -
排序结果:使用
OrderBy
属性根据一个或多个字段对搜索结果排序。 您可以按升序或降序对结果进行排序。 -
分页:使用
limit
和cursor
属性在搜索API请求中定义分页属性。limit
属性定义API响应中要检索的最大项数。cursor
属性有助于检索limit
属性中定义的下一组资源的起点。 例如,如果您在API请求中将50
定义为限制,则可以使用cursor
属性启动并使用下一个API请求检索接下来的50个项目。
搜索资产API端点 search-assets-api-endpoint
Search Assets API请求中的端点必须采用以下格式:https://delivery-pXXXX-eYYYY.adobeaemcloud.com/adobe/assets/search
投放域的结构与Experience Manager创作环境的域类似。 唯一的区别是将术语author
替换为delivery
。
pXXXX
引用项目ID
eYYYY
引用环境ID
搜索资产API请求方法 search-assets-api-request-method
POST
搜索Assets API标头 search-assets-api-header
在“搜索资产API”中定义标头时,您需要提供以下详细信息:
headers: {
'Content-Type': 'application/json',
'X-Adobe-Accept-Experimental': '1',
Authorization: 'Bearer <YOUR_JWT_HERE>',
'X-Api-Key': 'YOUR_API_KEY_HERE'
},
要调用搜索API,需要在Authorization
详细信息中定义IMS令牌。 IMS令牌从技术帐户中获取。 请参阅获取AEM as a Cloud Service凭据以创建新的技术帐户。 请参阅生成访问令牌以生成IMS令牌并在搜索资产API请求标头中正确使用它。
要查看请求示例、响应示例和响应代码,请参阅搜索Assets API。