1

我用 django rest 框架和 django rest swagger 编写 Web API。

  • django-rest (0.0.1)
  • django-rest-swagger (2.1.2)
  • djangorestframework (3.6.3)

我尝试在视图方法或 APIView 方法中编写 Swagger YAML。方法功能没问题,功能描述渲染没问题。但是 GET/POST 方法参数不能被渲染。

视图方法不是使用任何数据库模型,而是自定义模型。

  • 如何在参数部分呈现自定义模型字段。
  • 如何在 Swagger UI 参数部分呈现 POST 正文。
  • 参数部分无法渲染,如何显示。

PS如果我用coreapi.Document写一个页面,参数可以很好地呈现。但是这种方式对于 API 文档来说太复杂了。希望 YAML 在 APIView 方法或 ViewSet 方法上没问题。

4

2 回答 2

0

如果使用视图集,则从 GenericViewSet 继承。

于 2019-10-02T13:15:57.680 回答
0

Swagger 实际上读取与 url 关联的视图并检查它用于哪个方法,如果它是 CreateAPIView (post),那么它将显示关于该 URL 的 POST 方法,然后它使用该特定视图搜索分配的序列化程序并从那里选择关联模型的输入字段。因此,如果您的情况一切正常,请逐步进行。

于 2019-08-23T11:12:59.547 回答