2014-11-25 19:04:38 +03:00
<!DOCTYPE html>
< html lang = "en" >
< head >
< meta http-equiv = "Content-Type" content = "text/html; charset=UTF-8" >
< meta charset = "utf-8" >
2015-05-15 11:19:49 +03:00
< title > Parsers - Django REST framework< / title >
2014-11-25 19:04:38 +03:00
< link href = "../../img/favicon.ico" rel = "icon" type = "image/x-icon" >
2018-10-11 16:48:33 +03:00
< link rel = "canonical" href = "https://www.django-rest-framework.org/api-guide/parsers/" / >
2014-11-25 19:04:38 +03:00
< meta name = "viewport" content = "width=device-width, initial-scale=1.0" >
< meta name = "description" content = "Django, API, REST, Parsers" >
< meta name = "author" content = "Tom Christie" >
<!-- Le styles -->
< link href = "../../css/prettify.css" rel = "stylesheet" >
< link href = "../../css/bootstrap.css" rel = "stylesheet" >
< link href = "../../css/bootstrap-responsive.css" rel = "stylesheet" >
< link href = "../../css/default.css" rel = "stylesheet" >
<!-- Le HTML5 shim, for IE6 - 8 support of HTML5 elements -->
<!-- [if lt IE 9]>
< script src = "http://html5shim.googlecode.com/svn/trunk/html5.js" > < / script >
<![endif]-->
< script type = "text/javascript" >
var _gaq = _gaq || [];
_gaq.push(['_setAccount', 'UA-18852272-2']);
_gaq.push(['_trackPageview']);
(function() {
var ga = document.createElement('script');
ga.type = 'text/javascript';
ga.async = true;
ga.src = ('https:' == document.location.protocol ? 'https://ssl' : 'http://www') + '.google-analytics.com/ga.js';
var s = document.getElementsByTagName('script')[0];
s.parentNode.insertBefore(ga, s);
})();
< / script >
< style >
2016-05-26 13:48:39 +03:00
#sidebarInclude img {
margin-bottom: 10px;
}
#sidebarInclude a.promo {
2014-11-25 19:04:38 +03:00
color: black;
2016-05-26 13:48:39 +03:00
}
2014-11-25 19:04:38 +03:00
@media (max-width: 767px) {
div.promo {
display: none;
}
}
< / style >
< / head >
< body onload = "prettyPrint()" class = "-page" >
< div class = "wrapper" >
< div class = "navbar navbar-inverse navbar-fixed-top" >
< div class = "navbar-inner" >
< div class = "container-fluid" >
2017-05-12 19:15:00 +03:00
< a class = "repo-link btn btn-primary btn-small" href = "https://github.com/encode/django-rest-framework/tree/master" > GitHub< / a >
2015-06-04 17:37:22 +03:00
< a class = "repo-link btn btn-inverse btn-small " rel = "prev" href = "../renderers/" >
2014-11-25 19:04:38 +03:00
Next < i class = "icon-arrow-right icon-white" > < / i >
< / a >
2015-06-04 17:37:22 +03:00
< a class = "repo-link btn btn-inverse btn-small " rel = "next" href = "../routers/" >
2014-11-25 19:04:38 +03:00
< i class = "icon-arrow-left icon-white" > < / i > Previous
< / a >
2015-06-04 17:37:22 +03:00
< a id = "search_modal_show" class = "repo-link btn btn-inverse btn-small" href = "#mkdocs_search_modal" data-toggle = "modal" data-target = "#mkdocs_search_modal" > < i class = "icon-search icon-white" > < / i > Search< / a >
2014-11-25 19:04:38 +03:00
< a class = "btn btn-navbar" data-toggle = "collapse" data-target = ".nav-collapse" >
< span class = "icon-bar" > < / span >
< span class = "icon-bar" > < / span >
< span class = "icon-bar" > < / span >
< / a >
2018-10-11 16:48:33 +03:00
< a class = "brand" href = "https://www.django-rest-framework.org/" > Django REST framework< / a >
2014-11-25 19:04:38 +03:00
< div class = "nav-collapse collapse" >
<!-- Main navigation -->
< ul class = "nav navbar-nav" >
2015-06-04 17:37:22 +03:00
< li >
< a href = "../.." > Home< / a >
< / li >
2014-11-25 19:04:38 +03:00
< li class = "dropdown" >
2014-11-25 19:31:00 +03:00
< a href = "#" class = "dropdown-toggle" data-toggle = "dropdown" > Tutorial < b class = "caret" > < / b > < / a >
2014-11-25 19:04:38 +03:00
< ul class = "dropdown-menu" >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../tutorial/quickstart/" > Quickstart< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../tutorial/1-serialization/" > 1 - Serialization< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../tutorial/2-requests-and-responses/" > 2 - Requests and responses< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../tutorial/3-class-based-views/" > 3 - Class based views< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../tutorial/4-authentication-and-permissions/" > 4 - Authentication and permissions< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../tutorial/5-relationships-and-hyperlinked-apis/" > 5 - Relationships and hyperlinked APIs< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../tutorial/6-viewsets-and-routers/" > 6 - Viewsets and routers< / a >
2014-11-25 19:04:38 +03:00
< / li >
2016-07-14 15:05:57 +03:00
< li >
< a href = "../../tutorial/7-schemas-and-client-libraries/" > 7 - Schemas and client libraries< / a >
< / li >
2014-11-25 19:04:38 +03:00
< / ul >
< / li >
< li class = "dropdown active" >
< a href = "#" class = "dropdown-toggle" data-toggle = "dropdown" > API Guide < b class = "caret" > < / b > < / a >
< ul class = "dropdown-menu" >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../requests/" > Requests< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../responses/" > Responses< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../views/" > Views< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../generic-views/" > Generic views< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../viewsets/" > Viewsets< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../routers/" > Routers< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li class = "active" >
2015-06-04 17:37:22 +03:00
< a href = "./" > Parsers< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../renderers/" > Renderers< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../serializers/" > Serializers< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../fields/" > Serializer fields< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../relations/" > Serializer relations< / a >
2014-11-25 19:04:38 +03:00
< / li >
2014-12-01 15:20:07 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../validators/" > Validators< / a >
2014-12-01 15:20:07 +03:00
< / li >
2014-11-25 19:04:38 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../authentication/" > Authentication< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../permissions/" > Permissions< / a >
2014-11-25 19:04:38 +03:00
< / li >
2018-10-11 16:48:33 +03:00
< li >
< a href = "../caching/" > Caching< / a >
< / li >
2014-11-25 19:04:38 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../throttling/" > Throttling< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../filtering/" > Filtering< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../pagination/" > Pagination< / a >
2014-11-25 19:04:38 +03:00
< / li >
2015-03-06 15:05:16 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../versioning/" > Versioning< / a >
2015-03-06 15:05:16 +03:00
< / li >
2014-11-25 19:04:38 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../content-negotiation/" > Content negotiation< / a >
2014-11-25 19:04:38 +03:00
< / li >
2014-12-18 18:42:42 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../metadata/" > Metadata< / a >
2014-12-18 18:42:42 +03:00
< / li >
2016-07-07 11:41:32 +03:00
< li >
< a href = "../schemas/" > Schemas< / a >
< / li >
2014-11-25 19:04:38 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../format-suffixes/" > Format suffixes< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../reverse/" > Returning URLs< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../exceptions/" > Exceptions< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../status-codes/" > Status codes< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../testing/" > Testing< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../settings/" > Settings< / a >
2014-11-25 19:04:38 +03:00
< / li >
< / ul >
< / li >
< li class = "dropdown" >
< a href = "#" class = "dropdown-toggle" data-toggle = "dropdown" > Topics < b class = "caret" > < / b > < / a >
< ul class = "dropdown-menu" >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../topics/documenting-your-api/" > Documenting your API< / a >
2014-11-25 19:04:38 +03:00
< / li >
2016-07-07 11:41:32 +03:00
< li >
< a href = "../../topics/api-clients/" > API Clients< / a >
< / li >
2015-03-06 15:05:16 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../topics/internationalization/" > Internationalization< / a >
2015-03-06 15:05:16 +03:00
< / li >
2014-11-25 19:04:38 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../topics/ajax-csrf-cors/" > AJAX, CSRF & CORS< / a >
2014-11-25 19:04:38 +03:00
< / li >
2015-10-28 14:35:39 +03:00
< li >
< a href = "../../topics/html-and-forms/" > HTML & Forms< / a >
< / li >
2014-11-25 19:04:38 +03:00
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../topics/browser-enhancements/" > Browser Enhancements< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../topics/browsable-api/" > The Browsable API< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2015-06-04 17:37:22 +03:00
< a href = "../../topics/rest-hypermedia-hateoas/" > REST, Hypermedia & HATEOAS< / a >
2014-11-25 19:04:38 +03:00
< / li >
2018-10-11 16:48:33 +03:00
< / ul >
< / li >
< li class = "dropdown" >
< a href = "#" class = "dropdown-toggle" data-toggle = "dropdown" > Community < b class = "caret" > < / b > < / a >
< ul class = "dropdown-menu" >
2014-11-25 19:04:38 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/tutorials-and-resources/" > Tutorials and Resources< / a >
2017-02-25 22:59:44 +03:00
< / li >
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/third-party-packages/" > Third Party Packages< / a >
2014-11-25 19:04:38 +03:00
< / li >
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/contributing/" > Contributing to REST framework< / a >
2014-11-25 19:04:38 +03:00
< / li >
2014-12-18 16:49:50 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/project-management/" > Project management< / a >
2014-12-18 16:49:50 +03:00
< / li >
2017-03-09 17:59:14 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/release-notes/" > Release Notes< / a >
2017-03-09 17:59:14 +03:00
< / li >
2018-10-18 13:50:44 +03:00
< li >
< a href = "../../community/3.9-announcement/" > 3.9 Announcement< / a >
< / li >
2014-11-25 19:04:38 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.8-announcement/" > 3.8 Announcement< / a >
2014-11-25 19:04:38 +03:00
< / li >
2014-12-01 15:20:07 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.7-announcement/" > 3.7 Announcement< / a >
2014-12-01 15:20:07 +03:00
< / li >
2015-08-06 16:31:52 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.6-announcement/" > 3.6 Announcement< / a >
2015-08-06 16:31:52 +03:00
< / li >
2015-10-28 14:35:39 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.5-announcement/" > 3.5 Announcement< / a >
2015-10-28 14:35:39 +03:00
< / li >
2016-07-14 15:05:57 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.4-announcement/" > 3.4 Announcement< / a >
2016-07-14 15:05:57 +03:00
< / li >
2016-10-20 18:31:37 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.3-announcement/" > 3.3 Announcement< / a >
2016-10-20 18:31:37 +03:00
< / li >
2017-03-09 17:59:14 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.2-announcement/" > 3.2 Announcement< / a >
2017-03-09 17:59:14 +03:00
< / li >
2017-10-06 15:06:25 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.1-announcement/" > 3.1 Announcement< / a >
2017-10-06 15:06:25 +03:00
< / li >
2018-04-03 16:54:40 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/3.0-announcement/" > 3.0 Announcement< / a >
2018-04-03 16:54:40 +03:00
< / li >
2014-11-25 19:04:38 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/kickstarter-announcement/" > Kickstarter Announcement< / a >
2014-11-25 19:04:38 +03:00
< / li >
2016-05-26 13:48:39 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/mozilla-grant/" > Mozilla Grant< / a >
2016-05-26 13:48:39 +03:00
< / li >
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/funding/" > Funding< / a >
2016-05-26 13:48:39 +03:00
< / li >
2014-11-25 19:04:38 +03:00
< li >
2018-10-11 16:48:33 +03:00
< a href = "../../community/jobs/" > Jobs< / a >
2014-11-25 19:04:38 +03:00
< / li >
< / ul >
< / li >
< / ul >
< / div >
<!-- /.nav - collapse -->
< / div >
< / div >
< / div >
< div class = "body-content" >
< div class = "container-fluid" >
<!-- Search Modal -->
2015-06-04 17:37:22 +03:00
< div id = "mkdocs_search_modal" class = "modal hide fade" tabindex = "-1" role = "dialog" aria-labelledby = "myModalLabel" aria-hidden = "true" >
2014-11-25 19:04:38 +03:00
< div class = "modal-header" >
< button type = "button" class = "close" data-dismiss = "modal" aria-hidden = "true" > × < / button >
< h3 id = "myModalLabel" > Documentation search< / h3 >
< / div >
< div class = "modal-body" >
2015-08-06 16:31:52 +03:00
< form role = "form" autocomplete = "off" >
2015-06-04 17:37:22 +03:00
< div class = "form-group" >
< input type = "text" name = "q" class = "form-control" placeholder = "Search..." id = "mkdocs-search-query" >
< / div >
< / form >
< div id = "mkdocs-search-results" > < / div >
2014-11-25 19:04:38 +03:00
< / div >
< div class = "modal-footer" >
< button class = "btn" data-dismiss = "modal" aria-hidden = "true" > Close< / button >
< / div >
< / div >
< div class = "row-fluid" >
< div class = "span3" >
< div id = "table-of-contents" >
< ul class = "nav nav-list side-nav well sidebar-nav-fixed" >
< li class = "main" >
< a href = "#parsers" > Parsers< / a >
< / li >
< li >
< a href = "#how-the-parser-is-determined" > How the parser is determined< / a >
< / li >
< li >
< a href = "#setting-the-parsers" > Setting the parsers< / a >
< / li >
< li class = "main" >
< a href = "#api-reference" > API Reference< / a >
< / li >
< li >
< a href = "#jsonparser" > JSONParser< / a >
< / li >
< li >
< a href = "#formparser" > FormParser< / a >
< / li >
< li >
< a href = "#multipartparser" > MultiPartParser< / a >
< / li >
< li >
< a href = "#fileuploadparser" > FileUploadParser< / a >
< / li >
< li class = "main" >
< a href = "#custom-parsers" > Custom parsers< / a >
< / li >
< li >
< a href = "#stream" > stream< / a >
< / li >
< li >
< a href = "#media_type" > media_type< / a >
< / li >
< li >
< a href = "#parser_context" > parser_context< / a >
< / li >
< li >
< a href = "#example" > Example< / a >
< / li >
< li class = "main" >
< a href = "#third-party-packages" > Third party packages< / a >
< / li >
2015-03-06 15:05:16 +03:00
< li >
< a href = "#yaml" > YAML< / a >
< / li >
< li >
< a href = "#xml" > XML< / a >
< / li >
2014-11-25 19:04:38 +03:00
< li >
< a href = "#messagepack" > MessagePack< / a >
< / li >
< li >
< a href = "#camelcase-json" > CamelCase JSON< / a >
< / li >
2016-05-26 13:48:39 +03:00
< div class = "promo" >
< hr / >
< div id = "sidebarInclude" >
< / div >
2014-11-25 19:04:38 +03:00
< / ul >
< / div >
< / div >
< div id = "main-content" class = "span9" >
2015-06-04 17:37:22 +03:00
2018-10-16 15:02:48 +03:00
< a class = "github" href = "https://github.com/encode/django-rest-framework/tree/master/rest_framework/parsers.py" >
< span class = "label label-info" > parsers.py< / span >
2015-06-04 17:37:22 +03:00
< / a >
2014-11-25 19:04:38 +03:00
2015-11-04 17:59:23 +03:00
< h1 id = "parsers" > < a class = "toclink" href = "#parsers" > Parsers< / a > < / h1 >
2014-11-25 19:04:38 +03:00
< blockquote >
< p > Machine interacting web services tend to use more
structured formats for sending data than form-encoded, since they're
sending more complex data than simple forms< / p >
< p > — Malcom Tredinnick, < a href = "https://groups.google.com/d/topic/django-developers/dxI4qVzrBY4/discussion" > Django developers group< / a > < / p >
< / blockquote >
< p > REST framework includes a number of built in Parser classes, that allow you to accept requests with various media types. There is also support for defining your own custom parsers, which gives you the flexibility to design the media types that your API accepts.< / p >
2015-11-04 17:59:23 +03:00
< h2 id = "how-the-parser-is-determined" > < a class = "toclink" href = "#how-the-parser-is-determined" > How the parser is determined< / a > < / h2 >
2014-12-01 15:20:07 +03:00
< p > The set of valid parsers for a view is always defined as a list of classes. When < code > request.data< / code > is accessed, REST framework will examine the < code > Content-Type< / code > header on the incoming request, and determine which parser to use to parse the request content.< / p >
2014-11-25 19:04:38 +03:00
< hr / >
< p > < strong > Note< / strong > : When developing client applications always remember to make sure you're setting the < code > Content-Type< / code > header when sending data in an HTTP request.< / p >
< p > If you don't set the content type, most clients will default to using < code > 'application/x-www-form-urlencoded'< / code > , which may not be what you wanted.< / p >
2018-01-15 17:42:44 +03:00
< p > As an example, if you are sending < code > json< / code > encoded data using jQuery with the < a href = "https://api.jquery.com/jQuery.ajax/" > .ajax() method< / a > , you should make sure to include the < code > contentType: 'application/json'< / code > setting.< / p >
2014-11-25 19:04:38 +03:00
< hr / >
2015-11-04 17:59:23 +03:00
< h2 id = "setting-the-parsers" > < a class = "toclink" href = "#setting-the-parsers" > Setting the parsers< / a > < / h2 >
2015-03-06 15:05:16 +03:00
< p > The default set of parsers may be set globally, using the < code > DEFAULT_PARSER_CLASSES< / code > setting. For example, the following settings would allow only requests with < code > JSON< / code > content, instead of the default of JSON or form data.< / p >
2014-11-25 19:04:38 +03:00
< pre > < code > REST_FRAMEWORK = {
'DEFAULT_PARSER_CLASSES': (
2015-03-06 15:05:16 +03:00
'rest_framework.parsers.JSONParser',
2014-11-25 19:04:38 +03:00
)
}
< / code > < / pre >
< p > You can also set the parsers used for an individual view, or viewset,
2016-07-14 15:05:57 +03:00
using the < code > APIView< / code > class-based views.< / p >
2015-03-06 15:05:16 +03:00
< pre > < code > from rest_framework.parsers import JSONParser
2014-11-25 19:04:38 +03:00
from rest_framework.response import Response
from rest_framework.views import APIView
class ExampleView(APIView):
"""
2015-03-06 15:05:16 +03:00
A view that can accept POST requests with JSON content.
2014-11-25 19:04:38 +03:00
"""
2015-03-06 15:05:16 +03:00
parser_classes = (JSONParser,)
2014-11-25 19:04:38 +03:00
def post(self, request, format=None):
2014-12-01 15:20:07 +03:00
return Response({'received data': request.data})
2014-11-25 19:04:38 +03:00
< / code > < / pre >
< p > Or, if you're using the < code > @api_view< / code > decorator with function based views.< / p >
2015-12-14 15:52:03 +03:00
< pre > < code > from rest_framework.decorators import api_view
from rest_framework.decorators import parser_classes
2017-11-06 14:07:26 +03:00
from rest_framework.parsers import JSONParser
2015-12-14 15:52:03 +03:00
@api_view(['POST'])
2015-03-06 15:05:16 +03:00
@parser_classes((JSONParser,))
2014-11-25 19:04:38 +03:00
def example_view(request, format=None):
"""
2015-03-06 15:05:16 +03:00
A view that can accept POST requests with JSON content.
2014-11-25 19:04:38 +03:00
"""
2014-12-01 15:20:07 +03:00
return Response({'received data': request.data})
2014-11-25 19:04:38 +03:00
< / code > < / pre >
< hr / >
2015-11-04 17:59:23 +03:00
< h1 id = "api-reference" > < a class = "toclink" href = "#api-reference" > API Reference< / a > < / h1 >
< h2 id = "jsonparser" > < a class = "toclink" href = "#jsonparser" > JSONParser< / a > < / h2 >
2014-11-25 19:04:38 +03:00
< p > Parses < code > JSON< / code > request content.< / p >
< p > < strong > .media_type< / strong > : < code > application/json< / code > < / p >
2015-11-04 17:59:23 +03:00
< h2 id = "formparser" > < a class = "toclink" href = "#formparser" > FormParser< / a > < / h2 >
2014-12-01 15:20:07 +03:00
< p > Parses HTML form content. < code > request.data< / code > will be populated with a < code > QueryDict< / code > of data.< / p >
2014-11-25 19:04:38 +03:00
< p > You will typically want to use both < code > FormParser< / code > and < code > MultiPartParser< / code > together in order to fully support HTML form data.< / p >
< p > < strong > .media_type< / strong > : < code > application/x-www-form-urlencoded< / code > < / p >
2015-11-04 17:59:23 +03:00
< h2 id = "multipartparser" > < a class = "toclink" href = "#multipartparser" > MultiPartParser< / a > < / h2 >
2014-12-01 15:20:07 +03:00
< p > Parses multipart HTML form content, which supports file uploads. Both < code > request.data< / code > will be populated with a < code > QueryDict< / code > .< / p >
2014-11-25 19:04:38 +03:00
< p > You will typically want to use both < code > FormParser< / code > and < code > MultiPartParser< / code > together in order to fully support HTML form data.< / p >
< p > < strong > .media_type< / strong > : < code > multipart/form-data< / code > < / p >
2015-11-04 17:59:23 +03:00
< h2 id = "fileuploadparser" > < a class = "toclink" href = "#fileuploadparser" > FileUploadParser< / a > < / h2 >
2014-12-01 15:20:07 +03:00
< p > Parses raw file upload content. The < code > request.data< / code > property will be a dictionary with a single key < code > 'file'< / code > containing the uploaded file.< / p >
2016-06-24 13:07:42 +03:00
< p > If the view used with < code > FileUploadParser< / code > is called with a < code > filename< / code > URL keyword argument, then that argument will be used as the filename.< / p >
< p > If it is called without a < code > filename< / code > URL keyword argument, then the client must set the filename in the < code > Content-Disposition< / code > HTTP header. For example < code > Content-Disposition: attachment; filename=upload.jpg< / code > .< / p >
2014-11-25 19:04:38 +03:00
< p > < strong > .media_type< / strong > : < code > */*< / code > < / p >
2015-11-04 17:59:23 +03:00
< h5 id = "notes" > < a class = "toclink" href = "#notes" > Notes:< / a > < / h5 >
2014-11-25 19:04:38 +03:00
< ul >
2019-01-16 16:29:55 +03:00
< li > The < code > FileUploadParser< / code > is for usage with native clients that can upload the file as a raw data request. For web-based uploads, or for native clients with multipart upload support, you should use the < code > MultiPartParser< / code > instead.< / li >
2014-11-25 19:04:38 +03:00
< li > Since this parser's < code > media_type< / code > matches any content type, < code > FileUploadParser< / code > should generally be the only parser set on an API view.< / li >
2016-12-09 19:07:34 +03:00
< li > < code > FileUploadParser< / code > respects Django's standard < code > FILE_UPLOAD_HANDLERS< / code > setting, and the < code > request.upload_handlers< / code > attribute. See the < a href = "https://docs.djangoproject.com/en/stable/topics/http/file-uploads/#upload-handlers" > Django documentation< / a > for more details.< / li >
2014-11-25 19:04:38 +03:00
< / ul >
2015-11-04 17:59:23 +03:00
< h5 id = "basic-usage-example" > < a class = "toclink" href = "#basic-usage-example" > Basic usage example:< / a > < / h5 >
2016-06-24 13:07:42 +03:00
< pre > < code > # views.py
class FileUploadView(views.APIView):
2014-11-25 19:04:38 +03:00
parser_classes = (FileUploadParser,)
def put(self, request, filename, format=None):
2014-12-01 15:20:07 +03:00
file_obj = request.data['file']
2014-11-25 19:04:38 +03:00
# ...
2015-02-11 01:56:05 +03:00
# do some stuff with uploaded file
2014-11-25 19:04:38 +03:00
# ...
return Response(status=204)
2016-06-24 13:07:42 +03:00
# urls.py
urlpatterns = [
# ...
url(r'^upload/(?P< filename> [^/]+)$', FileUploadView.as_view())
]
2014-11-25 19:04:38 +03:00
< / code > < / pre >
< hr / >
2015-11-04 17:59:23 +03:00
< h1 id = "custom-parsers" > < a class = "toclink" href = "#custom-parsers" > Custom parsers< / a > < / h1 >
2014-11-25 19:04:38 +03:00
< p > To implement a custom parser, you should override < code > BaseParser< / code > , set the < code > .media_type< / code > property, and implement the < code > .parse(self, stream, media_type, parser_context)< / code > method.< / p >
2014-12-01 15:20:07 +03:00
< p > The method should return the data that will be used to populate the < code > request.data< / code > property.< / p >
2014-11-25 19:04:38 +03:00
< p > The arguments passed to < code > .parse()< / code > are:< / p >
2015-11-04 17:59:23 +03:00
< h3 id = "stream" > < a class = "toclink" href = "#stream" > stream< / a > < / h3 >
2014-11-25 19:04:38 +03:00
< p > A stream-like object representing the body of the request.< / p >
2015-11-04 17:59:23 +03:00
< h3 id = "media_type" > < a class = "toclink" href = "#media_type" > media_type< / a > < / h3 >
2014-11-25 19:04:38 +03:00
< p > Optional. If provided, this is the media type of the incoming request content.< / p >
< p > Depending on the request's < code > Content-Type:< / code > header, this may be more specific than the renderer's < code > media_type< / code > attribute, and may include media type parameters. For example < code > "text/plain; charset=utf-8"< / code > .< / p >
2015-11-04 17:59:23 +03:00
< h3 id = "parser_context" > < a class = "toclink" href = "#parser_context" > parser_context< / a > < / h3 >
2014-11-25 19:04:38 +03:00
< p > Optional. If supplied, this argument will be a dictionary containing any additional context that may be required to parse the request content.< / p >
< p > By default this will include the following keys: < code > view< / code > , < code > request< / code > , < code > args< / code > , < code > kwargs< / code > .< / p >
2015-11-04 17:59:23 +03:00
< h2 id = "example" > < a class = "toclink" href = "#example" > Example< / a > < / h2 >
2015-03-06 15:05:16 +03:00
< p > The following is an example plaintext parser that will populate the < code > request.data< / code > property with a string representing the body of the request.< / p >
2014-11-25 19:04:38 +03:00
< pre > < code > class PlainTextParser(BaseParser):
"""
2015-08-06 16:31:52 +03:00
Plain text parser.
2014-11-25 19:04:38 +03:00
"""
2015-08-06 16:31:52 +03:00
media_type = 'text/plain'
def parse(self, stream, media_type=None, parser_context=None):
"""
Simply return a string representing the body of the request.
"""
return stream.read()
2014-11-25 19:04:38 +03:00
< / code > < / pre >
< hr / >
2015-11-04 17:59:23 +03:00
< h1 id = "third-party-packages" > < a class = "toclink" href = "#third-party-packages" > Third party packages< / a > < / h1 >
2014-11-25 19:04:38 +03:00
< p > The following third party packages are also available.< / p >
2015-11-04 17:59:23 +03:00
< h2 id = "yaml" > < a class = "toclink" href = "#yaml" > YAML< / a > < / h2 >
2018-01-15 17:42:44 +03:00
< p > < a href = "https://jpadilla.github.io/django-rest-framework-yaml/" > REST framework YAML< / a > provides < a href = "http://www.yaml.org/" > YAML< / a > parsing and rendering support. It was previously included directly in the REST framework package, and is now instead supported as a third-party package.< / p >
2015-11-04 17:59:23 +03:00
< h4 id = "installation-configuration" > < a class = "toclink" href = "#installation-configuration" > Installation & configuration< / a > < / h4 >
2015-03-06 15:05:16 +03:00
< p > Install using pip.< / p >
< pre > < code > $ pip install djangorestframework-yaml
< / code > < / pre >
< p > Modify your REST framework settings.< / p >
< pre > < code > REST_FRAMEWORK = {
'DEFAULT_PARSER_CLASSES': (
'rest_framework_yaml.parsers.YAMLParser',
),
'DEFAULT_RENDERER_CLASSES': (
'rest_framework_yaml.renderers.YAMLRenderer',
),
}
< / code > < / pre >
2015-11-04 17:59:23 +03:00
< h2 id = "xml" > < a class = "toclink" href = "#xml" > XML< / a > < / h2 >
2018-01-15 17:42:44 +03:00
< p > < a href = "https://jpadilla.github.io/django-rest-framework-xml/" > REST Framework XML< / a > provides a simple informal XML format. It was previously included directly in the REST framework package, and is now instead supported as a third-party package.< / p >
2015-11-04 17:59:23 +03:00
< h4 id = "installation-configuration_1" > < a class = "toclink" href = "#installation-configuration_1" > Installation & configuration< / a > < / h4 >
2015-03-06 15:05:16 +03:00
< p > Install using pip.< / p >
< pre > < code > $ pip install djangorestframework-xml
< / code > < / pre >
< p > Modify your REST framework settings.< / p >
< pre > < code > REST_FRAMEWORK = {
'DEFAULT_PARSER_CLASSES': (
'rest_framework_xml.parsers.XMLParser',
),
'DEFAULT_RENDERER_CLASSES': (
'rest_framework_xml.renderers.XMLRenderer',
),
}
< / code > < / pre >
2015-11-04 17:59:23 +03:00
< h2 id = "messagepack" > < a class = "toclink" href = "#messagepack" > MessagePack< / a > < / h2 >
2014-11-25 19:04:38 +03:00
< p > < a href = "https://github.com/juanriaza/django-rest-framework-msgpack" > MessagePack< / a > is a fast, efficient binary serialization format. < a href = "https://github.com/juanriaza" > Juan Riaza< / a > maintains the < a href = "https://github.com/juanriaza/django-rest-framework-msgpack" > djangorestframework-msgpack< / a > package which provides MessagePack renderer and parser support for REST framework.< / p >
2015-11-04 17:59:23 +03:00
< h2 id = "camelcase-json" > < a class = "toclink" href = "#camelcase-json" > CamelCase JSON< / a > < / h2 >
2014-11-25 19:04:38 +03:00
< p > < a href = "https://github.com/vbabiy/djangorestframework-camel-case" > djangorestframework-camel-case< / a > provides camel case JSON renderers and parsers for REST framework. This allows serializers to use Python-style underscored field names, but be exposed in the API as Javascript-style camel case field names. It is maintained by < a href = "https://github.com/vbabiy" > Vitaly Babiy< / a > .< / p >
2015-06-04 17:37:22 +03:00
2015-06-23 14:05:53 +03:00
< / div > <!-- /span -->
< / div > <!-- /row -->
< / div > <!-- /.fluid - container -->
< / div > <!-- /.body content -->
2014-11-25 19:04:38 +03:00
< div id = "push" > < / div >
2015-06-23 14:05:53 +03:00
< / div > <!-- /.wrapper -->
2014-11-25 19:04:38 +03:00
< footer class = "span12" >
2015-10-28 14:35:39 +03:00
< p > Documentation built with < a href = "http://www.mkdocs.org/" > MkDocs< / a > .
2014-11-25 19:04:38 +03:00
< / p >
< / footer >
<!-- Le javascript
================================================== -->
<!-- Placed at the end of the document so the pages load faster -->
< script src = "../../js/jquery-1.8.1-min.js" > < / script >
< script src = "../../js/prettify-1.0.js" > < / script >
< script src = "../../js/bootstrap-2.1.1-min.js" > < / script >
2016-05-26 13:48:39 +03:00
< script src = "https://fund.django-rest-framework.org/sidebar_include.js" > < / script >
2015-06-04 17:37:22 +03:00
< script > var base _url = '../..' ; < / script >
< script src = "../../mkdocs/js/require.js" > < / script >
2014-12-11 12:55:10 +03:00
< script src = "../../js/theme.js" > < / script >
2014-11-25 19:04:38 +03:00
< script >
var shiftWindow = function() {
scrollBy(0, -50)
};
2015-06-23 14:05:53 +03:00
2014-11-25 19:04:38 +03:00
if (location.hash) shiftWindow();
window.addEventListener("hashchange", shiftWindow);
$('.dropdown-menu').on('click touchstart', function(event) {
event.stopPropagation();
});
2015-06-23 14:05:53 +03:00
// Dynamically force sidenav/dropdown to no higher than browser window
$('.side-nav, .dropdown-menu').css('max-height', window.innerHeight - 130);
2014-11-25 19:04:38 +03:00
$(function() {
$(window).resize(function() {
2015-06-23 14:05:53 +03:00
$('.side-nav, .dropdown-menu').css('max-height', window.innerHeight - 130);
2014-11-25 19:04:38 +03:00
});
});
< / script >
< / body >
< / html >
