0

我想在 DRF 中使用 swagger 生成器工具django-rest-swagger记录我的 API

现在我正在通过继承来编写视图rest_framework.views.APIView

我不想使用视图集或序列化程序编写视图。

这是查看代码示例

from rest_framework.views import APIView
class SomeView(APIView):
  '''
  get:
    some description
  post:
    some other description
 '''
 def get(self, request, format=None):
    a = self.request.query_params.get('a',None)
    b = self.request.query_params.get('b',None)
    c = self.request.query_params.get('c',None)
    return Response({},status='200')

 def post(self, request, format=None):
    a = self.request.data.get('a',None)
    b = self.request.data.get('b',None)
    c = self.request.data.get('c',None)
    return Response({},status='201')

现在我可以为每个端点添加描述。 swagger ui中每个api端点的描述

我想添加请求和响应模式,如下所示swagger 中每个端点的模型模式

我想知道,如何在不使用序列化程序和视图集的情况下实现这一点。

4

2 回答 2

2

我相信在当前版本的 django-rest-swagger YAML 文档字符串(如您的示例中)已被弃用。因此,我认为您需要手动定义您的架构。文档包括如何在视图级别执行此操作的示例:

http://www.django-rest-framework.org/api-guide/schemas/#manualschema

于 2018-08-09T23:21:33.333 回答
1

我知道我没有直接回答你的问题,但我想建议你尝试一个很棒的包,它可以在各个方向定制:drf-yasg. 您没有义务使用通用的 rest_framework 东西或序列化程序。

您可以直接跳转到自定义模式生成

于 2018-08-09T23:21:05.353 回答