为文件上传的查询参数大加注解

Question

我正在尝试为基于symfony的api创建api文档，我想添加有关api上传端点的信息。我正在使用nelmioapidocbundle。谁能提供我可以找到的文档链接？或有一个例子更好。谢谢。

/**
 * @Route("/products/{id}/images", methods={"POST"})
 * 
 * @SWG\Parameter(
 *      name="file",
 *      in="body",
 *      type="file",
 *      ---- Im not sure what to put here to make this work
 * )
 * 
 * @SWG\Response(
 *          response=201,
 *          description="File is uploaded."
 *      )
 * )
 */
public function uploadImages(Request $request, FileUploadService $fileUploadService) {}

Answer 1

对于任何可能遇到此问题的人。此formData的值已解决问题：

 * @SWG\Parameter( 
 *      name="file", 
 *      in="formData", <----
 *      required=true, 
 *      type="file", 
 *      description="product image"