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衝突 ​狀態碼(如先前記錄的那樣)。

  • 端點範例: POST /adobe/folders

  • 範例要求:傳送POST要求至/adobe/folders,並附上JSON內文,指定資料夾路徑和標題。

  • 實際回應範例:

    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衝突 ​狀態代碼。 此變更可能尚未出現在公開檔案中。

解決方法 resolution

請依照下列步驟解決問題:

  1. 檢閱最新的Folders 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