我正在考虑使用 this library 为我的 Web 服务实现 JSON-RPC。我还想为我的服务实现Swagger。
但是，我不确定这两者是否是一个很好的组合。在 JSON-RPC 中，所有方法都在同一个资源后面，而在 Swagger 中这没有任何意义。
我想知道以下几点：
感谢您的想法。
相关的未回答问题：Swagger and json-rpc
【问题讨论】：
关于 API 模式的一句话...
JSON-RPC 非常强大。它与传输无关，因为 REST 被锁定到 HTTP。如果你想使用流而不是孤立的请求，你将不得不做很多事情。 JSON-RPC 从一开始就改变了你的范式，通过任何新的传输（socket.io、原始二进制文件、ZeroMQ、传真->OCR、sms、任何东西）运行你的 API 都是一个简单的实现。
在我看来，JSON-RPC 之于 REST，就像 REST 之于 SOAP
【讨论】：
来自 Swagger 团队，对 JSON-RPC 知之甚少，我可以提供部分答案。
根据您在问题中的描述，绝对不可能使用 Swagger 来记录这样的 API。 Swagger 只能记录唯一操作被定义为路径和 HTTP 动词的组合的唯一操作。
不幸的是，我无法评论 JSON-RPC 的强大功能，不是因为偏见，而是因为我对它的机制不够了解。此外，Swagger 在描述类似 REST 的 API 时并不打算覆盖 100% 的用例，这并不意味着超出其范围的任何东西都是不好的。
【讨论】：