JSON-RPC Кураж сочетание

Question

Я рассматриваю реализовать JSON-RPC для моего веб-службы с this library. Я также хотел бы реализовать Swagger для моего обслуживания.

Однако, я не уверен, если эти два хорошее сочетание вместе. В JSON-RPC все методы находятся за одним и тем же ресурсом, в то время как это не имеет никакого смысла в Swagger.

Я интересно следующее:

1. Можно ли объединить эти технологии в полную силу?
2. Является ли JSON-RPC хорошей технологией для использования? Или лучше реализовать его вручную?

Ваши мысли приветствуются.

Связанные, unaswered вопрос: Swagger and json-rpc

Answer 1

Исходя из команды Swagger, и имеющие мало знаний о JSON-RPC, я могу предоставить частичный ответ.

Основываясь на том, что вы описали в вопросе, это, безусловно, не представляется возможным использовать Swagger документировать такой API. Swagger может документировать уникальные операции, когда уникальная операция определяется как комбинация пути и HTTP-глагола.

К сожалению, я не могу комментировать о силе JSON-RPC, а не из-за смещения, но потому, что я не достаточно его механики известно. Чтобы добавить к этому, Swagger не стремится покрывать 100% случаев использования при описании REST-подобных API, и это не означает, что что-то из его объема не является хорошим.

Answer 2

Слово по образцу API ...

JSON-RPC является невероятно мощным. Это транспортная агностика, где REST блокируется HTTP. Если вы хотите использовать поток вместо изолированных запросов, вам придется немного взломать. JSON-RPC изменяет вашу парадигму с самого начала и запускает ваш API через любой новый транспорт (socket.io, raw binary, ZeroMQ, fax-> OCR, sms, anything) - тривиальная реализация.

На мой взгляд, JSON-RPC является REST, так как REST является SOAP