Question

我正在尝试使用Slim写一点Api。我希望记录得非常好，所以我安装了swagger-php和UI，并在最后几天对其进行了调查。出于某种原因，我的petstore演示缺少所有帖子注释。我的API在此示例中将如下所示：

http://coenraets.org/blog/2011/12/restful-services-with-jquery-php-and-the-slim-framework/

addWine（）函数的swagger注释如何？如何注释函数的结果（最后一个插入id），因为它不是模型？

一个例子真的很棒。谢谢

Answer 1

这样做。可能不是这样的，而是完全按照我的意愿行事。

/**
* @package
* @category
* @subpackage
*
* @SWG\Resource(
*   apiVersion="1.0.0",
*   swaggerVersion="1.2",
*   basePath="http://myapi",
*   resourcePath="/hello",
*   description="Giving you your name in case you forgot it",
*   produces="['application/json','application/xml','text/plain','text/html']"
* )
*/

/**
 * @SWG\Api(
 *   path="/hello/{yourname}",
 *   @SWG\Operation(
 *     method="GET",
 *     summary="Gives you your name",
 *     notes="Returns your name",
 *     type="hello",
 *     nickname="yourname",
 *     @SWG\Parameter(
 *       name="yourname",
 *       description="Enter your name",
 *       required=true,
 *       type="text",
 *       paramType="path"
 *     ),
 *     @SWG\ResponseMessage(code=404, message="Bad, really bad name.")
 *   )
 * )
 *
     */ 

 /**
     * @package
     * @category
     * @subpackage
     *
     * @SWG\Model(id="hello",required="name")
     */

/**
 * @SWG\Property(name="name",type="string",description="Your name")
 */

如何正确地为swagger注释这个函数？

1 个答案: