xml - REST 服务是否应该为 XML 响应公开 XSD？

Question

我们构建了一个 REST 服务，它根据接受 header 将 XML 或 JSON 返回给客户端，或者根据内容类型 header 接受 XML 或 JSON。

最近一位集成商问我们是否有用于 XML 响应和请求的 XSD 架构。

这是开发 REST 服务时的常见做法吗？

Answer 1

为任何服务(包括 REST)的调用者提供该服务的某种形式的接口(interface)定义是绝对常见的做法。如果您有 XML 接口(interface)，某种 XML 模式(XSD、RELAX NG、Schematron 等)是定义请求和 响应界面。除了提供文档外，验证解析器还可以使用它来捕获对已声明接口(interface)的违反。

您也可以考虑创建 JSON Schema JSON 接口(interface)的定义。它可以提供一些与 XML 模式相同的好处，但可以说它不像 XML 模式对 XML 的“常见做法”。