django rest framework swagger 的测试配置

swagger有着自动生成API文档的功能,当然也可以测试。
自己在写APIView的时候,request的自己定义的参数是不能自己生成的,只有在path中的才可以,如何解决这个问题?

解决的思路:

翻看源码,原来get_swagger_view返回的是schema对象,也就是APIView中的schema属性,所以我们只要设置schema就ok了。

class TestView(APIView):
'''
    测试
'''

schema = AutoSchema(
    manual_fields=[
        coreapi.Field(name='code', required=True, location='form', description='', type='string'),
    ]
)

这个就是效果:

image.png

现在可以通过Try it out这个按钮来进行测试了,告别自己写API文档,告别自己用postman来测试,安心的码代码搬砖吧😏😏!!!

通过coreapi_Field中的location你可以设置任何参数,location有下列可选选项可以选:

"path" "query" "form" "header"
包含在模板化URI中。例如,url值/products/{product_code}/可以与"path"字段一起使用。 包含在URL查询参数中。例如?search=sale。通常用于GET请求。 包含在请求正文中,作为JSON对象或HTML表单的单个项目。例如{"colour": "blue", ...}。通常的POST,PUT和PATCH请求。"form"单个链接上可以包含多个字段。 包含在请求头中,可以自定义。

具体操作请看DRF的文档schemas

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
【社区内容提示】社区部分内容疑似由AI辅助生成,浏览时请结合常识与多方信息审慎甄别。
平台声明:文章内容(如有图片或视频亦包括在内)由作者上传并发布,文章内容仅代表作者本人观点,简书系信息发布平台,仅提供信息存储服务。

相关阅读更多精彩内容

友情链接更多精彩内容