Я планирую реализовать JSON-RPC для моего веб-сервиса с эта библиотека. Я также хотел бы реализовать развязность для моего обслуживания.
Тем не менее, я не уверен, что эти два — хорошая комбинация вместе. В JSON-RPC все методы находятся за одним и тем же ресурсом, хотя в Swagger это не имеет никакого смысла.
Мне интересно следующее:
Ваши мысли ценятся.
Связанный, оставшийся без ответа вопрос: Swagger и JSON-RPC
Исходя из команды Swagger и имея немного знаний о JSON-RPC, я могу дать частичный ответ.
Исходя из того, что вы описали в вопросе, определенно было бы невозможно использовать Swagger для документирования такого API. Swagger может документировать только уникальные операции, где уникальная операция определяется как комбинация пути и глагола HTTP.
К сожалению, я не могу комментировать силу JSON-RPC не из-за предвзятости, а потому, что я недостаточно осведомлен о его механике. Чтобы добавить к этому, Swagger не ставит целью охватить 100% случаев использования при описании REST-подобных API, и это не означает, что что-либо вне его области не является хорошим.
Слово о шаблоне API …
JSON-RPC невероятно мощный. Это транспортная независимость, где REST привязан к HTTP. Если вы хотите использовать поток вместо изолированных запросов, вам придется немного взломать. JSON-RPC меняет вашу парадигму с самого начала, и запуск вашего API через любой новый транспорт (socket.io, raw binary, ZeroMQ, fax-> OCR, sms, что угодно) является тривиальной реализацией.
На мой взгляд, JSON-RPC предназначен для REST, а REST для SOAP