AEM文件夹API会为现有文件夹返回HTTP 200,而不是HTTP 409
当文件夹创建请求定位现有文件夹时,Adobe Experience Manager as a Cloud Service (AEMaaCS)文件夹API返回HTTP 200 OK。 最近的更改提供了响应有效负载中的冲突详细信息,而不是返回HTTP 409冲突,这可能会影响仅依赖于HTTP状态代码的集成。 要解决此问题,请评估响应有效负载中的错误数组,并将冲突条目视为失败的文件夹创建操作。
描述 description
环境
Adobe Experience Manager as a Cloud Service (AEMaaCS),所有版本
问题/症状
-
当您使用AEM文件夹API创建已存在的文件夹时,该API返回 HTTP 200 OK 状态代码。
-
响应有效负载包含冲突错误,而不是返回以前记录的 HTTP 409 Conflict 状态代码。
-
终结点示例:
POST /adobe/folders -
示例请求:使用JSON正文指定文件夹路径和标题将
POST请求发送到/adobe/folders。 -
示例实际响应:
code language-none { "operation": "adobe.folders.createFolders", "status": 200, "description": "Created folders", "data": { "values": { "successes": [ ] } }, "errors": [ { "type": "https://api.adobeaemcloud.com/adobe/meta/errors/conflict", "title": "Conflict", "detail": "An entity already exists at /content/dam/example/path/to/folder" } ] , "warnings": [ ] }
根本原因
文件夹API行为中的最近更改针对文件夹创建冲突返回HTTP 200 OK,并在响应有效负载中提供冲突详细信息,而不是返回 HTTP 409 Conflict 状态代码。 此更改可能尚未显示在公共文档中。
解决方法 resolution
请按照以下步骤解决问题:
- 查看最新的文件夹API文档,了解有关冲突处理的更新。
- 更新集成逻辑,以便在确定文件夹创建请求的结果时评估HTTP状态代码和响应有效负载。
- 检查响应有效负载中的
errors数组以查找将type设置为https://api.adobeaemcloud.com/adobe/meta/errors/conflict的条目。 - 如果响应包含此条目,则无论HTTP状态代码如何,都将操作视为冲突。
- 如果工作流需要严格的HTTP状态代码处理,请实施其他逻辑来解析响应正文以获取错误详细信息。
- 监控API文档和发行说明,了解冲突响应合同的更新或更改。
- 尝试创建已存在的文件夹。 确认响应有效负载在
errors数组中包含冲突错误,即使HTTP状态代码为 200 也是如此。
recommendation-more-help
experience-cloud-kcs-help-kbarticles