XML API中返回的错误的格​​式

Question

我正在构建一个基于XML消息的API。在其中的一部分，接收几个实体并处理它们。

现在，如果其中一个实体出现处理错误，我想继续处理其他实体并返回未处理的实体的错误消息，以便消费者知道哪些实体未被处理。

返回这些错误的最佳方法是什么，以便消费者确切地知道哪些实体失败以及哪些错误消息？

以下是请求的样子：

<entities>
  <entity>
    <title>first</title>
    <description>short text</description>
  </entity>
  <entity>
    <title>second</title>
    <description>second short text</description>
  </entity>
  <entity>
    <title>third</title>
    <description>third short text</description>
  </entity>
</entities>

现在让我们假设第一个和第三个实体产生错误。响应怎么样？

Answer 1

这是我选择的解决方案：

响应将类似于请求，这意味着它将包含相同的实体结构，但只会返回生成错误的实体，并且错误将附加到原始实体节点。

<entities>
  <entity>
    <title>first</title>
    <description>short text</description>
  </entity>
  <errors>
    <error>first error</error>
    <error>second error</error>
  </errors>
</entities>