STARBLOG · 一册不断续写的手记页次 01

0_Swagger与drf-yasg接口文档系列

关于技术、实践，以及沿途所想。把走过的路，折进文字里。2 篇 · 随写随记

经验总结-drf-yasg接口文档几个细节的自定义方式

drf-yasg是Django RestFramework的一个扩展, 可以根据路由生成OpenApi接口, 不过用起来和在Java平台和.NetCore有很多不一样的, 有些自定义的地方也比较麻烦, 不过看看文档也还好, 可以解决. 本文记录几个在实际开发中遇到的, 虽然是细节, 但是优化好细节可以给对接的同事带来很大的方便~ 顺带一提, Python写后台真的太快了, 一上午出几十个接口你能信

2022-04-04阅读全文

0_Swagger与drf-yasg接口文档系列

解决drf-yasg中的SwaggerAPI无法正确分组问题

swagger是后台开发中很好用的交互式文档，Django原本的Django-Swagger已经停止维护了，现在一般用drf_yasg这个包来实现文档，它里面支持swagger和redoc两种，redoc是静态的，作为导出文档的话不错，不过一般我们用swagger，因为可以在文档里面调试，非常方便。 Drf里面有个东西是AutoSchema，可以自动扫描ViewSet和APIView这类可以提供接

2022-04-04阅读全文