JSON-RPC с APIBlueprint

Apiary предоставляет чистый интерфейс для объявления параметров URI, что позволяет легко экспериментировать через консоль с хорошим заполнением пустого интерфейса.

Возможно ли это сделать для json-rpc или любого параметра тела http? Если нет, то это было бы невероятно полезно.


person Rob Rodriguez    schedule 27.04.2014    source источник


Ответы (1)


Это пока невозможно, но скоро это будет доступно через описание тела сообщения.

Однако это для произвольных параметров кузова. Я не уверен, что JSON-RPC будет хорошо работать для проекта API, поскольку он больше моделируется вокруг ресурсов; поскольку RPC «перегружает» один ресурс, результат, вероятно, будет не очень хорошим.

person Almad    schedule 27.04.2014
comment
Я рассматриваю возможность использования API Blueprint для документирования API JSON-RPC. На основании этого вопроса и ответа это не рекомендуется. Это все еще не рекомендуется..? - person Dynom; 26.07.2016
comment
Описание тела сообщения есть (через MSON), но на самом деле не пробовал с ним JSON-RPC. Я думаю, у вас все еще будут проблемы с запутанной документацией. Вы можете попробовать, дайте нам знать, как все прошло! - person Almad; 28.07.2016