我正在尝试将 Swagger-ui 用于由 php 编写的 json-rpc 服务器。我使用Swagger-PHP为 Swagger-ui 生成 json 投诉容器。所以,我对 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 容器将为每个请求都有自己的“方法”。
问题 - 我应该从哪里开始寻找解决这个问题?
对不起我的英语不好。不是本地人。