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
請依照下列步驟解決問題:
- 檢閱最新的Folders 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