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

时间:2013-02-08 12:03:33

标签: xml web-services api

我正在构建一个基于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>

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

1 个答案:

答案 0 :(得分:0)

这是我选择的解决方案:

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

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