Я пытаюсь использовать Swagger-ui для своего сервера json-rpc, написанного на php. Я использую Swagger-PHP для создания контейнера жалоб json для Swagger-ui. Итак, я очень новичок в Swagger и использую аннотацию для таких методов:
/**
* @SWG\Resource(
* apiVersion="0.2",
* swaggerVersion="0.8",
* basePath="http://mydomain.com",
* @SWG\Api(
* path="/rpc/json/server.php",
* description="Operations about Devices",
* @SWG\Operations(
* @SWG\Operation(
* method="POST",
* summary="Get device by ID",
* nickname="getDevice",
* @SWG\Parameters(
* @SWG\Parameter(
* name="deviceID",
* description="device id",
* required="true",
* type="string"
* )
* ),
* @SWG\ResponseMessages(
* @SWG\ResponseMessage(code=404, message="Device not found")
* )
* )
* )
* )
* )
*/
В SWG\Operation мне нужно добавить еще один "метод" в соответствии с json-rpc spec. В результате все запросы будут использовать метод POST как часть http, а json-контейнер будет иметь свой собственный «метод» для каждого из них.
Вопрос - с чего начать поиск для решения этой проблемы?
Извините за мой английский. Не родной.