JSON-RPC Swagger组合

Question

我正在考虑使用此库为我的Web服务实现JSON-RPC 。我也想为我的服务实现Swagger。

但是，我不确定这两者是否可以很好地组合在一起。在JSON-RPC中，所有方法都位于同一资源的后面，而在Swagger中则没有任何意义。

我想知道以下几点：

1. 是否可以将这些技术完全结合在一起？
2. JSON-RPC仍然是使用的好技术吗？还是手动实施更好？

您的想法受到赞赏。

相关，未提出疑问的问题：Swagger和json-rpc

Answer 1

来自Swagger团队，对JSON-RPC知识很少，我可以提供部分答案。

根据您在问题中描述的内容，绝对不可能使用Swagger来记录此类API。Swagger只能记录将唯一操作定义为路径和HTTP动词的组合的唯一操作。

不幸的是，我不能评论JSON-RPC的功能，这不是因为偏见，而是因为我对其机制还不够了解。此外，在描述类似REST的API时，Swagger并不打算涵盖100％的用例，这并不意味着超出其范围的任何事情都是不好的。

Answer 2

关于 API 模式的一句话...

JSON-RPC 非常强大。它与传输无关，而 REST 则锁定为 HTTP。如果您想使用流而不是孤立的请求，您将不得不进行大量修改。JSON-RPC 从一开始就改变了您的范例，并且通过任何新传输（socket.io、原始二进制文件、ZeroMQ、传真->OCR、短信等）运行您的 API 都是一个简单的实现。

在我看来，JSON-RPC 之于 REST，就像 REST 之于 SOAP 一样