Openapi 3与Django drf

Question

我使用Django和Django-Drf来编写restful。

我也在使用drf-yasg来为我的服务生成高傲的方案。

不幸的是，drf还不支持OpenApi3，看起来在可预见的将来也不会支持。

除了Drf，还有什么替代方案可以支持Openapi 3和Django-Drf一起使用呢？

Answer 1

Django最近增加了OpenAPI3支持(我认为是3.10)，但它缺乏DRF所拥有的许多功能。即将发布的版本(3.12)将添加组件支持，但仍然缺少许多功能，比如方便的定制选项。

我们发现自己在中的情况与完全相同。经过一些认真的搜索后，我们发现是空的，因此创建了一个经过大量修改的DRF OpenAPI3实现，它正在慢慢接近drf的功能。

https://github.com/tfranzel/drf-spectacular

试试看。它还在形成，但已经涵盖了很多案件。欢迎反馈！

Answer 2

您可以创建自己的html文件，在openAPI3支持下加载yaml或json，并通过Django发布它。

可以在这里找到一个可以使用的模板：https://github.com/yousan/swagger-yaml-to-html/blob/master/swagger-yaml-to-html.py

基本openAPI模板：

openapi: "3.0.0"
info:
    title: MY-Api
    description: My API
    version: 1.0.0
servers:
paths:

编写将更改传播到文件中的基本脚本，您就完成了。

您将丢失由DRF或swagger包进行的自动架构更新。但是您可以使用这个命令来生成它们。

python manage.py generateschema