- Language: en
- Documentation version: 3.12
- Generic views
- Serializer fields
- Serializer relations
- Content negotiation
- Format suffixes
- Returning URLs
- Status codes
- Tutorials and Resources
- Third Party Packages
- Contributing to REST framework
- Project management
- Release Notes
- 3.12 Announcement
- 3.11 Announcement
- 3.10 Announcement
- 3.9 Announcement
- 3.8 Announcement
- 3.7 Announcement
- 3.6 Announcement
- 3.5 Announcement
- 3.4 Announcement
- 3.3 Announcement
- 3.2 Announcement
- 3.1 Announcement
- 3.0 Announcement
- Kickstarter Announcement
- Mozilla Grant
Django REST framework 3.3¶
The 3.3 release marks the final work in the Kickstarter funded series. We’d like to offer a final resounding thank you to all our wonderful sponsors and supporters.
The amount of work that has been achieved as a direct result of the funding is immense. We’ve added a huge amounts of new functionality, resolved nearly 2,000 tickets, and redesigned & refined large parts of the project.
In order to continue driving REST framework forward, we’ll shortly be announcing a new set of funding plans. Follow @_tomchristie to keep up to date with these announcements, and be among the first set of sign ups.
We strongly believe that collaboratively funded software development yields outstanding results for a relatively low investment-per-head. If you or your company use REST framework commercially, then we would strongly urge you to participate in this latest funding drive, and help us continue to build an increasingly polished & professional product.
Significant new functionality in the 3.3 release includes:
Filters presented as HTML controls in the browsable API.
A forms API, allowing serializers to be rendered as HTML forms.
Django 1.9 support.
A ``JSONField:doc:` serializer field <../api-guide/fields#jsonfield>`, corresponding to Django 1.9’s Postgres
Browsable API support via AJAX, rather than server side request overloading.
Example of the new filter controls
This release drops support for Django 1.5 and 1.6. Django 1.7, 1.8 or 1.9 are now required.
This brings our supported versions into line with Django’s currently supported versions
The AJAX based support for the browsable API means that there are a number of internal cleanups in the
request class. For the vast majority of developers this should largely remain transparent:
To support form based
acceptquery parameter is no longer supported by the default content negotiation class. If you require it then you’ll need to use a custom content negotiation class.
HTTP_X_HTTP_METHOD_OVERRIDEheader is no longer supported by default. If you require it then you’ll need to use custom middleware.
The following pagination view attributes and settings have been moved into attributes on the pagination class since 3.1. Their usage was formerly deprecated, and has now been removed entirely, in line with the deprecation policy.
HyperlinkedModelSerializer classes should now include either a
exclude option, although the
fields = '__all__' shortcut may be used. Failing to include either of these two options is currently pending deprecation, and will be removed entirely in the 3.5 release. This behavior brings
ModelSerializer more closely in line with Django’s