Question

我正在将POST请求转换为GET请求。我正在使用NelmioApiDocBundle记录我的API端点。我目前有以下（旧）注释：

/**
 * @SWG\Response(
 *     response=200,
 *     description="Success - return JSON",
 * )
 * @SWG\Tag(name="Open Vacancies")
 *
 * @SWG\Parameter(
 *     name="Message body",
 *     in="body",
 *     type="string",
 *     description="JSON string specifying a page number and page size",
 *     required=true,
 *     @SWG\Schema(
 *         type="object",
 *         @SWG\Property(property="page", type="integer"),
 *         @SWG\Property(property="pageSize", type="integer")
 *     )
 * )
 *
 * @Route("/open-vacancies", methods={"POST"}, defaults={"_format": "json"}, name="api.open_vacancies")
 */

现在，我希望开发人员能够使用https://myapi.myapp.com/open-vacancies?page=1&pageSize=10之类的URL来调用我的端点。但是我不知道如何以注释形式定义文档。 Google对我没有太大帮助。有人可以指出我相关的文档吗（否则，请输入我可以使用的注释示例）？

Answer 1

要记录查询参数，您还可以使用@SWG\Parameter批注，但是将in的值设置为query而不是body

示例：

/**
 * @SWG\Parameter(
 *     name="pageSize",
 *     in="query",
 *     type="string",
 *     description="Description goes here"
 * )
 */

挥舞注解查询参数

1 个答案: