Swagger and json-rpc

I am trying to use Swagger-ui for my json-rpc server that was written by php. I am using Swagger-PHP to create a json complaints container for Swagger-ui. So, I'm very new to Swagger, and I use annotation for such methods:

/**
 *  @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")
 *                  )
 *              )
 *          )
 *      )
 *  )
*/

In SWG \ Operation, I need to add another "method" in accordance with the json-rpc spec . As a result, all requests will use the POST method as part of http, and the json container will have its own "method" for each of them.

Question - where should I start the search to solve this problem?

Sorry for my English. Non-native.

+1
1

@SWG\Operation() s @SWG\Api() @SWG\Operations()

, @SWG\Api().

?, json-rpc.

0

Source: https://habr.com/ru/post/1583947/


All Articles