mirror of
https://github.com/encode/django-rest-framework.git
synced 2024-11-22 17:47:04 +03:00
47ee3fc9a9
* Update docs related to coreapi to include deprecation notice * Update docs to use reference to version 3.10 release notes instead of 3.9
30 lines
1.3 KiB
Markdown
30 lines
1.3 KiB
Markdown
# Legacy CoreAPI Schemas Docs
|
|
|
|
Use of CoreAPI-based schemas were deprecated with the introduction of native OpenAPI-based schema generation as of Django REST Framework v3.10.
|
|
|
|
See the [Version 3.10 Release Announcement](../community/3.10-announcement.md) for more details.
|
|
|
|
----
|
|
|
|
You can continue to use CoreAPI schemas by setting the appropriate default schema class:
|
|
|
|
```python
|
|
# In settings.py
|
|
REST_FRAMEWORK = {
|
|
'DEFAULT_SCHEMA_CLASS': 'rest_framework.schemas.coreapi.AutoSchema',
|
|
}
|
|
```
|
|
|
|
Under-the-hood, any subclass of `coreapi.AutoSchema` here will trigger use of the old CoreAPI schemas.
|
|
**Otherwise** you will automatically be opted-in to the new OpenAPI schemas.
|
|
|
|
All CoreAPI related code will be removed in Django REST Framework v3.12. Switch to OpenAPI schemas by then.
|
|
|
|
----
|
|
|
|
For reference this folder contains the old CoreAPI related documentation:
|
|
|
|
* [Tutorial 7: Schemas & client libraries](https://github.com/encode/django-rest-framework/blob/master/docs/coreapi//7-schemas-and-client-libraries.md).
|
|
* [Excerpts from _Documenting your API_ topic page](https://github.com/encode/django-rest-framework/blob/master/docs/coreapi//from-documenting-your-api.md).
|
|
* [`rest_framework.schemas` API Reference](https://github.com/encode/django-rest-framework/blob/master/docs/coreapi//schemas.md).
|