drf-spectacular¶
Sane and flexible OpenAPI 3 schema generation for Django REST framework.
Documentation is an integral part of API development and OpenAPI 3 is finally here to make that process a easier. By using drf-spectacular with Django REST Framework (DRF), your schema and therefore your documentation & client will always stay close to your API.
drf-spectacular works well out of the box, but also provides you with several easy ways to customize the generated OpenAPI 3 schema. It is explicitly designed to work well for documentation (SwaggerUI, ReDoc) and automatic client generation.
Table of Contents¶
- drf-spectacular
- Settings
- Workflow & schema customization
- Client generation
- FAQ
- I use library/app XXX and the generated schema is wrong or broken
- I cannot use
@extend_schema
on library code - I get an empty schema or endpoints are missing
- I expected a different schema
- I get duplicated operations with a
{format}
-suffix - I get a lot of warnings
- I get warnings regarding my
Enum
or myEnum
names have a weird suffix - My endpoints use different serializers depending on the situation
- My authentication method is not supported
- How can I i18n/internationalize my schema and UI?
- FileField (ImageField) is not handled properly in the schema
- I’m using
@action(detail=False)
but the response schema is not a list - Using
@extend_schema
onAPIView
has no effect - Where should i put my extensions? / my extensions are not detected
- Extension Blueprints
- From drf-yasg to OpenAPI 3
- License
- Changelog
- 0.15.1 (2021-04-08)
- 0.15.0 (2021-04-03)
- 0.14.0 (2021-03-09)
- 0.13.2 (2021-02-11)
- 0.13.1 (2021-01-21)
- 0.13.0 (2021-01-13)
- 0.12.0 (2020-12-19)
- 0.11.1 (2020-11-15)
- 0.11.0 (2020-11-06)
- 0.10.0 (2020-10-20)
- 0.9.14 (2020-10-04)
- 0.9.13 (2020-09-13)
- 0.9.12 (2020-07-22)
- 0.9.11 (2020-07-08)
- 0.9.10 (2020-06-23)
- 0.9.9 (2020-06-20)
- 0.9.8 (2020-06-07)
- 0.9.7 (2020-06-05)
- 0.9.6 (2020-05-23)
- 0.9.5 (2020-05-20)
- 0.9.4 (2020-05-13)
- 0.9.3 (2020-05-07)
- 0.9.2 (2020-04-27)
- 0.9.1 (2020-04-09)
- 0.9.0 (2020-03-29)
- 0.8.8 (2020-03-21)
- 0.8.5 (2020-03-08)
- 0.8.4 (2020-03-06)
- 0.8.3 (2020-03-02)
- 0.8.2 (2020-03-02)
- 0.8.1 (2020-03-01)
- Package overview