Symfony RequestBody不显示架构的 swagger 注解

klr1opcd  于 2022-11-16  发布在  其他
关注(0)|答案(1)|浏览(282)

我在Symfony中使用nelmio/api-doc-bundle v4.9作为文档。

  1. * @OA\RequestBody(
  2. * required=true,
  3. * @OA\JsonContent(
  4. * example={
  5. * "file": "file",
  6. * "documentCategoryCode": "O"
  7. * },
  8. * @OA\Schema(
  9. * type="object",
  10. * @OA\Property(
  11. * property="file",
  12. * required=true,
  13. * type="file",
  14. * description="File to be uploaded",
  15. * example="file"
  16. * ),
  17. * @OA\Property(
  18. * property="documentCategoryCode",
  19. * required=true,
  20. * type="string",
  21. * description="Document category")
  22. * ),
  23. * )
  24. * )
  25. * )

它显示了这个例子的精细:

但是,“Schema”部分是一个空对象,就像属性无法识别一样

知道我错过了什么吗?

piwo6bdm

piwo6bdm1#

  1. * @OA\RequestBody(
  2. * required=true,
  3. * @OA\JsonContent(
  4. * example={
  5. * "file": "file",
  6. * "documentCategoryCode": "O"
  7. * },
  8. * required={"file", "documentCategoryCode"},
  9. * @OA\Property(
  10. * property="file",
  11. * type="file",
  12. * description="File to be uploaded",
  13. * example="file"
  14. * ),
  15. * @OA\Property(
  16. * property="documentCategoryCode",
  17. * type="string",
  18. * description="Document category")
  19. * )
  20. * )
  21. * )

感谢@Helen的建议,这是最后起作用的注解。

展开查看全部

相关问题