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

请按照以下步骤解决问题:

  1. 查看最新的文件夹API文档,了解有关冲突处理的更新。
  2. 更新集成逻辑,以便在确定文件夹创建请求的结果时评估HTTP状态代码和响应有效负载。
  3. 检查响应有效负载中的errors数组以查找将type设置为https://api.adobeaemcloud.com/adobe/meta/errors/conflict的条目。
  4. 如果响应包含此条目,则无论HTTP状态代码如何,都将操作视为冲突。
  5. 如果工作流需要严格的HTTP状态代码处理,请实施其他逻辑来解析响应正文以获取错误详细信息。
  6. 监控API文档和发行说明,了解冲突响应合同的更新或更改。
  7. 尝试创建已存在的文件夹。 确认响应有效负载在errors数组中包含冲突错误,即使HTTP状态代码为​ 200 ​也是如此。
recommendation-more-help
experience-cloud-kcs-help-kbarticles