Я пытаюсь с Nelmio Api Doc 3.4, который использует Swagger.
Я только хочу создать собственный маршрут Api для действия в моем контроллере:
/**
* @Operation(
* path="/product/{portal}/{code}",
* method="GET",
* tags={"Product Api"},
* summary="Returns a collection of products",
* @SWG\Response(
* response="200",
* description="Returned when successful",
* @SWG\Schema(
* type="array",
* @Model(type=AppBundle\Model\Api\ProductList::class)
* )
* ),
* @SWG\Parameter(
* name="portal",
* in="query",
* type="string",
* default="de",
* required=true,
* description="The portal"
* ),
* @SWG\Parameter(
* name="code",
* in="query",
* type="string",
* default="",
* format="\d+",
* required=true,
* description="The code"
* )
* )
*
* @param Request $request
* @return ProductList
*/
public function getProductByBookingCode(Portal $portal, string $code)
{
dump($portal);die;
}
Но мой маршрут не отображается в моем API-интерфейсе, также нет тега. Но когда я пишу @Route("/product/{portal}/{code}", methods={"GET"})
поверх @Operation
, отображается маршрут, но затем с параметрами 2 portal
и 2 codes
.
Разве нельзя использовать форму path
param @Operation
, чтобы сделать мой маршрут видимым?