From 0ca8f7619707376574a6c890296aa68dd0ce729e Mon Sep 17 00:00:00 2001
From: Tom Christie Many thanks to all our wonderful sponsors, and in particular to our premium backers, Rover, Sentry, Stream, and Machinalis. Many thanks to all our wonderful sponsors, and in particular to our premium backers, Rover, Sentry, Stream, Machinalis, and Rollbar. REST framework requires the following:
Requirements
For support please see the REST framework discussion group, try the #restframework
channel on irc.freenode.net
, search the IRC archives, or raise a question on Stack Overflow, making sure to include the 'django-rest-framework' tag.
Paid support is available from DabApps, and can include work on REST framework core, or support with building your REST framework API. Please contact DabApps if you'd like to discuss commercial support options.
+For priority support please sign up for a professional or premium sponsorship plan.
For updates on REST framework development, you may also want to follow the author on Twitter.
diff --git a/mkdocs/search_index.json b/mkdocs/search_index.json index ced3d7d65..361291f7b 100644 --- a/mkdocs/search_index.json +++ b/mkdocs/search_index.json @@ -2,12 +2,12 @@ "docs": [ { "location": "/", - "text": ".promo li a {\n float: left;\n width: 130px;\n height: 20px;\n text-align: center;\n margin: 10px 30px;\n padding: 150px 0 0 0;\n background-position: 0 50%;\n background-size: 130px auto;\n background-repeat: no-repeat;\n font-size: 120%;\n color: black;\n}\n.promo li {\n list-style: none;\n}\n\n\n\n\n\n \n\n\n \n\n \n\n \n\n\n \n\n \n\n \n\n\n\n\n\n\n\nNote\n: This is the documentation for the \nversion 3\n of REST framework. Documentation for \nversion 2\n is also available.\n\n\n\n\n\n\nDjango REST Framework\n\n\n\n\n\n\n\n\nDjango REST framework is a powerful and flexible toolkit for building Web APIs.\n\n\nSome reasons you might want to use REST framework:\n\n\n\n\nThe \nWeb browsable API\n is a huge usability win for your developers.\n\n\nAuthentication policies\n including packages for \nOAuth1a\n and \nOAuth2\n.\n\n\nSerialization\n that supports both \nORM\n and \nnon-ORM\n data sources.\n\n\nCustomizable all the way down - just use \nregular function-based views\n if you don't need the \nmore\n \npowerful\n \nfeatures\n.\n\n\nExtensive documentation\n, and \ngreat community support\n.\n\n\nUsed and trusted by internationally recognised companies including \nMozilla\n, \nRed Hat\n, \nHeroku\n, and \nEventbrite\n.\n\n\n\n\n\n\nFunding\n\n\nREST framework is a \ncollaboratively funded project\n. If you use\nREST framework commercially we strongly encourage you to invest in its\ncontinued development by \nsigning up for a paid plan\n.\n\n\nThe initial aim is to provide a single full-time position on REST framework.\n\nEvery single sign-up makes a significant impact towards making that possible.\n\n\n\n \nRover.com\n\n \nSentry\n\n \nStream\n\n \nMachinalis\n\n\n\n\n\n\n\n\nMany thanks to all our \nwonderful sponsors\n, and in particular to our premium backers, \nRover\n, \nSentry\n, \nStream\n, and \nMachinalis\n.\n\n\n\n\nRequirements\n\n\nREST framework requires the following:\n\n\n\n\nPython (2.7, 3.2, 3.3, 3.4, 3.5)\n\n\nDjango (1.8, 1.9, 1.10)\n\n\n\n\nThe following packages are optional:\n\n\n\n\ncoreapi\n (1.32.0+) - Schema generation support.\n\n\nMarkdown\n (2.1.0+) - Markdown support for the browsable API.\n\n\ndjango-filter\n (0.9.2+) - Filtering support.\n\n\ndjango-crispy-forms\n - Improved HTML display for filtering.\n\n\ndjango-guardian\n (1.1.1+) - Object level permissions support.\n\n\n\n\nInstallation\n\n\nInstall using \npip\n, including any optional packages you want...\n\n\npip install djangorestframework\npip install markdown # Markdown support for the browsable API.\npip install django-filter # Filtering support\n\n\n\n...or clone the project from github.\n\n\ngit clone git@github.com:tomchristie/django-rest-framework.git\n\n\n\nAdd \n'rest_framework'\n to your \nINSTALLED_APPS\n setting.\n\n\nINSTALLED_APPS = (\n ...\n 'rest_framework',\n)\n\n\n\nIf you're intending to use the browsable API you'll probably also want to add REST framework's login and logout views. Add the following to your root \nurls.py\n file.\n\n\nurlpatterns = [\n ...\n url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))\n]\n\n\n\nNote that the URL path can be whatever you want, but you must include \n'rest_framework.urls'\n with the \n'rest_framework'\n namespace. You may leave out the namespace in Django 1.9+, and REST framework will set it for you.\n\n\nExample\n\n\nLet's take a look at a quick example of using REST framework to build a simple model-backed API.\n\n\nWe'll create a read-write API for accessing information on the users of our project.\n\n\nAny global settings for a REST framework API are kept in a single configuration dictionary named \nREST_FRAMEWORK\n. Start off by adding the following to your \nsettings.py\n module:\n\n\nREST_FRAMEWORK = {\n # Use Django's standard `django.contrib.auth` permissions,\n # or allow read-only access for unauthenticated users.\n 'DEFAULT_PERMISSION_CLASSES': [\n 'rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly'\n ]\n}\n\n\n\nDon't forget to make sure you've also added \nrest_framework\n to your \nINSTALLED_APPS\n.\n\n\nWe're ready to create our API now.\nHere's our project's root \nurls.py\n module:\n\n\nfrom django.conf.urls import url, include\nfrom django.contrib.auth.models import User\nfrom rest_framework import routers, serializers, viewsets\n\n# Serializers define the API representation.\nclass UserSerializer(serializers.HyperlinkedModelSerializer):\n class Meta:\n model = User\n fields = ('url', 'username', 'email', 'is_staff')\n\n# ViewSets define the view behavior.\nclass UserViewSet(viewsets.ModelViewSet):\n queryset = User.objects.all()\n serializer_class = UserSerializer\n\n# Routers provide an easy way of automatically determining the URL conf.\nrouter = routers.DefaultRouter()\nrouter.register(r'users', UserViewSet)\n\n# Wire up our API using automatic URL routing.\n# Additionally, we include login URLs for the browsable API.\nurlpatterns = [\n url(r'^', include(router.urls)),\n url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))\n]\n\n\n\nYou can now open the API in your browser at \nhttp://127.0.0.1:8000/\n, and view your new 'users' API. If you use the login control in the top right corner you'll also be able to add, create and delete users from the system.\n\n\nQuickstart\n\n\nCan't wait to get started? The \nquickstart guide\n is the fastest way to get up and running, and building APIs with REST framework.\n\n\nTutorial\n\n\nThe tutorial will walk you through the building blocks that make up REST framework. It'll take a little while to get through, but it'll give you a comprehensive understanding of how everything fits together, and is highly recommended reading.\n\n\n\n\n1 - Serialization\n\n\n2 - Requests \n Responses\n\n\n3 - Class-based views\n\n\n4 - Authentication \n permissions\n\n\n5 - Relationships \n hyperlinked APIs\n\n\n6 - Viewsets \n routers\n\n\n7 - Schemas \n client libraries\n\n\n\n\nThere is a live example API of the finished tutorial API for testing purposes, \navailable here\n.\n\n\nAPI Guide\n\n\nThe API guide is your complete reference manual to all the functionality provided by REST framework.\n\n\n\n\nRequests\n\n\nResponses\n\n\nViews\n\n\nGeneric views\n\n\nViewsets\n\n\nRouters\n\n\nParsers\n\n\nRenderers\n\n\nSerializers\n\n\nSerializer fields\n\n\nSerializer relations\n\n\nValidators\n\n\nAuthentication\n\n\nPermissions\n\n\nThrottling\n\n\nFiltering\n\n\nPagination\n\n\nVersioning\n\n\nContent negotiation\n\n\nMetadata\n\n\nSchemas\n\n\nFormat suffixes\n\n\nReturning URLs\n\n\nExceptions\n\n\nStatus codes\n\n\nTesting\n\n\nSettings\n\n\n\n\nTopics\n\n\nGeneral guides to using REST framework.\n\n\n\n\nDocumenting your API\n\n\nAPI Clients\n\n\nInternationalization\n\n\nAJAX, CSRF \n CORS\n\n\nHTML \n Forms\n\n\nBrowser enhancements\n\n\nThe Browsable API\n\n\nREST, Hypermedia \n HATEOAS\n\n\nThird Party Resources\n\n\nContributing to REST framework\n\n\nProject management\n\n\n3.0 Announcement\n\n\n3.1 Announcement\n\n\n3.2 Announcement\n\n\n3.3 Announcement\n\n\n3.4 Announcement\n\n\n3.5 Announcement\n\n\nKickstarter Announcement\n\n\nMozilla Grant\n\n\nFunding\n\n\nRelease Notes\n\n\n\n\nDevelopment\n\n\nSee the \nContribution guidelines\n for information on how to clone\nthe repository, run the test suite and contribute changes back to REST\nFramework.\n\n\nSupport\n\n\nFor support please see the \nREST framework discussion group\n, try the \n#restframework\n channel on \nirc.freenode.net\n, search \nthe IRC archives\n, or raise a question on \nStack Overflow\n, making sure to include the \n'django-rest-framework'\n tag.\n\n\nPaid support is available\n from \nDabApps\n, and can include work on REST framework core, or support with building your REST framework API. Please \ncontact DabApps\n if you'd like to discuss commercial support options.\n\n\nFor updates on REST framework development, you may also want to follow \nthe author\n on Twitter.\n\n\nFollow @_tomchristie\n\n\n!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=\"//platform.twitter.com/widgets.js\";fjs.parentNode.insertBefore(js,fjs);}}(document,\"script\",\"twitter-wjs\");\n\n\nSecurity\n\n\nIf you believe you\u2019ve found something in Django REST framework which has security implications, please \ndo not raise the issue in a public forum\n.\n\n\nSend a description of the issue via email to \nrest-framework-security@googlegroups.com\n. The project maintainers will then work with you to resolve any issues where required, prior to any public disclosure.\n\n\nLicense\n\n\nCopyright (c) 2011-2016, Tom Christie\nAll rights reserved.\n\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n\nRedistributions of source code must retain the above copyright notice, this\nlist of conditions and the following disclaimer.\nRedistributions in binary form must reproduce the above copyright notice, this\nlist of conditions and the following disclaimer in the documentation and/or\nother materials provided with the distribution.\n\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.", + "text": ".promo li a {\n float: left;\n width: 130px;\n height: 20px;\n text-align: center;\n margin: 10px 30px;\n padding: 150px 0 0 0;\n background-position: 0 50%;\n background-size: 130px auto;\n background-repeat: no-repeat;\n font-size: 120%;\n color: black;\n}\n.promo li {\n list-style: none;\n}\n\n\n\n\n\n \n\n\n \n\n \n\n \n\n\n \n\n \n\n \n\n\n\n\n\n\n\nNote\n: This is the documentation for the \nversion 3\n of REST framework. Documentation for \nversion 2\n is also available.\n\n\n\n\n\n\nDjango REST Framework\n\n\n\n\n\n\n\n\nDjango REST framework is a powerful and flexible toolkit for building Web APIs.\n\n\nSome reasons you might want to use REST framework:\n\n\n\n\nThe \nWeb browsable API\n is a huge usability win for your developers.\n\n\nAuthentication policies\n including packages for \nOAuth1a\n and \nOAuth2\n.\n\n\nSerialization\n that supports both \nORM\n and \nnon-ORM\n data sources.\n\n\nCustomizable all the way down - just use \nregular function-based views\n if you don't need the \nmore\n \npowerful\n \nfeatures\n.\n\n\nExtensive documentation\n, and \ngreat community support\n.\n\n\nUsed and trusted by internationally recognised companies including \nMozilla\n, \nRed Hat\n, \nHeroku\n, and \nEventbrite\n.\n\n\n\n\n\n\nFunding\n\n\nREST framework is a \ncollaboratively funded project\n. If you use\nREST framework commercially we strongly encourage you to invest in its\ncontinued development by \nsigning up for a paid plan\n.\n\n\nThe initial aim is to provide a single full-time position on REST framework.\n\nEvery single sign-up makes a significant impact towards making that possible.\n\n\n\n \nRover.com\n\n \nSentry\n\n \nStream\n\n \nMachinalis\n\n \nRollbar\n\n\n\n\n\n\n\n\nMany thanks to all our \nwonderful sponsors\n, and in particular to our premium backers, \nRover\n, \nSentry\n, \nStream\n, \nMachinalis\n, and \nRollbar\n.\n\n\n\n\nRequirements\n\n\nREST framework requires the following:\n\n\n\n\nPython (2.7, 3.2, 3.3, 3.4, 3.5)\n\n\nDjango (1.8, 1.9, 1.10)\n\n\n\n\nThe following packages are optional:\n\n\n\n\ncoreapi\n (1.32.0+) - Schema generation support.\n\n\nMarkdown\n (2.1.0+) - Markdown support for the browsable API.\n\n\ndjango-filter\n (0.9.2+) - Filtering support.\n\n\ndjango-crispy-forms\n - Improved HTML display for filtering.\n\n\ndjango-guardian\n (1.1.1+) - Object level permissions support.\n\n\n\n\nInstallation\n\n\nInstall using \npip\n, including any optional packages you want...\n\n\npip install djangorestframework\npip install markdown # Markdown support for the browsable API.\npip install django-filter # Filtering support\n\n\n\n...or clone the project from github.\n\n\ngit clone git@github.com:tomchristie/django-rest-framework.git\n\n\n\nAdd \n'rest_framework'\n to your \nINSTALLED_APPS\n setting.\n\n\nINSTALLED_APPS = (\n ...\n 'rest_framework',\n)\n\n\n\nIf you're intending to use the browsable API you'll probably also want to add REST framework's login and logout views. Add the following to your root \nurls.py\n file.\n\n\nurlpatterns = [\n ...\n url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))\n]\n\n\n\nNote that the URL path can be whatever you want, but you must include \n'rest_framework.urls'\n with the \n'rest_framework'\n namespace. You may leave out the namespace in Django 1.9+, and REST framework will set it for you.\n\n\nExample\n\n\nLet's take a look at a quick example of using REST framework to build a simple model-backed API.\n\n\nWe'll create a read-write API for accessing information on the users of our project.\n\n\nAny global settings for a REST framework API are kept in a single configuration dictionary named \nREST_FRAMEWORK\n. Start off by adding the following to your \nsettings.py\n module:\n\n\nREST_FRAMEWORK = {\n # Use Django's standard `django.contrib.auth` permissions,\n # or allow read-only access for unauthenticated users.\n 'DEFAULT_PERMISSION_CLASSES': [\n 'rest_framework.permissions.DjangoModelPermissionsOrAnonReadOnly'\n ]\n}\n\n\n\nDon't forget to make sure you've also added \nrest_framework\n to your \nINSTALLED_APPS\n.\n\n\nWe're ready to create our API now.\nHere's our project's root \nurls.py\n module:\n\n\nfrom django.conf.urls import url, include\nfrom django.contrib.auth.models import User\nfrom rest_framework import routers, serializers, viewsets\n\n# Serializers define the API representation.\nclass UserSerializer(serializers.HyperlinkedModelSerializer):\n class Meta:\n model = User\n fields = ('url', 'username', 'email', 'is_staff')\n\n# ViewSets define the view behavior.\nclass UserViewSet(viewsets.ModelViewSet):\n queryset = User.objects.all()\n serializer_class = UserSerializer\n\n# Routers provide an easy way of automatically determining the URL conf.\nrouter = routers.DefaultRouter()\nrouter.register(r'users', UserViewSet)\n\n# Wire up our API using automatic URL routing.\n# Additionally, we include login URLs for the browsable API.\nurlpatterns = [\n url(r'^', include(router.urls)),\n url(r'^api-auth/', include('rest_framework.urls', namespace='rest_framework'))\n]\n\n\n\nYou can now open the API in your browser at \nhttp://127.0.0.1:8000/\n, and view your new 'users' API. If you use the login control in the top right corner you'll also be able to add, create and delete users from the system.\n\n\nQuickstart\n\n\nCan't wait to get started? The \nquickstart guide\n is the fastest way to get up and running, and building APIs with REST framework.\n\n\nTutorial\n\n\nThe tutorial will walk you through the building blocks that make up REST framework. It'll take a little while to get through, but it'll give you a comprehensive understanding of how everything fits together, and is highly recommended reading.\n\n\n\n\n1 - Serialization\n\n\n2 - Requests \n Responses\n\n\n3 - Class-based views\n\n\n4 - Authentication \n permissions\n\n\n5 - Relationships \n hyperlinked APIs\n\n\n6 - Viewsets \n routers\n\n\n7 - Schemas \n client libraries\n\n\n\n\nThere is a live example API of the finished tutorial API for testing purposes, \navailable here\n.\n\n\nAPI Guide\n\n\nThe API guide is your complete reference manual to all the functionality provided by REST framework.\n\n\n\n\nRequests\n\n\nResponses\n\n\nViews\n\n\nGeneric views\n\n\nViewsets\n\n\nRouters\n\n\nParsers\n\n\nRenderers\n\n\nSerializers\n\n\nSerializer fields\n\n\nSerializer relations\n\n\nValidators\n\n\nAuthentication\n\n\nPermissions\n\n\nThrottling\n\n\nFiltering\n\n\nPagination\n\n\nVersioning\n\n\nContent negotiation\n\n\nMetadata\n\n\nSchemas\n\n\nFormat suffixes\n\n\nReturning URLs\n\n\nExceptions\n\n\nStatus codes\n\n\nTesting\n\n\nSettings\n\n\n\n\nTopics\n\n\nGeneral guides to using REST framework.\n\n\n\n\nDocumenting your API\n\n\nAPI Clients\n\n\nInternationalization\n\n\nAJAX, CSRF \n CORS\n\n\nHTML \n Forms\n\n\nBrowser enhancements\n\n\nThe Browsable API\n\n\nREST, Hypermedia \n HATEOAS\n\n\nThird Party Resources\n\n\nContributing to REST framework\n\n\nProject management\n\n\n3.0 Announcement\n\n\n3.1 Announcement\n\n\n3.2 Announcement\n\n\n3.3 Announcement\n\n\n3.4 Announcement\n\n\n3.5 Announcement\n\n\nKickstarter Announcement\n\n\nMozilla Grant\n\n\nFunding\n\n\nRelease Notes\n\n\n\n\nDevelopment\n\n\nSee the \nContribution guidelines\n for information on how to clone\nthe repository, run the test suite and contribute changes back to REST\nFramework.\n\n\nSupport\n\n\nFor support please see the \nREST framework discussion group\n, try the \n#restframework\n channel on \nirc.freenode.net\n, search \nthe IRC archives\n, or raise a question on \nStack Overflow\n, making sure to include the \n'django-rest-framework'\n tag.\n\n\nFor priority support please sign up for a \nprofessional or premium sponsorship plan\n.\n\n\nFor updates on REST framework development, you may also want to follow \nthe author\n on Twitter.\n\n\nFollow @_tomchristie\n\n\n!function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=\"//platform.twitter.com/widgets.js\";fjs.parentNode.insertBefore(js,fjs);}}(document,\"script\",\"twitter-wjs\");\n\n\nSecurity\n\n\nIf you believe you\u2019ve found something in Django REST framework which has security implications, please \ndo not raise the issue in a public forum\n.\n\n\nSend a description of the issue via email to \nrest-framework-security@googlegroups.com\n. The project maintainers will then work with you to resolve any issues where required, prior to any public disclosure.\n\n\nLicense\n\n\nCopyright (c) 2011-2016, Tom Christie\nAll rights reserved.\n\n\nRedistribution and use in source and binary forms, with or without\nmodification, are permitted provided that the following conditions are met:\n\n\nRedistributions of source code must retain the above copyright notice, this\nlist of conditions and the following disclaimer.\nRedistributions in binary form must reproduce the above copyright notice, this\nlist of conditions and the following disclaimer in the documentation and/or\nother materials provided with the distribution.\n\n\nTHIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS \"AS IS\" AND\nANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED\nWARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE\nDISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE\nFOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL\nDAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR\nSERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER\nCAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,\nOR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE\nOF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.", "title": "Home" }, { "location": "/#funding", - "text": "REST framework is a collaboratively funded project . If you use\nREST framework commercially we strongly encourage you to invest in its\ncontinued development by signing up for a paid plan . The initial aim is to provide a single full-time position on REST framework. Every single sign-up makes a significant impact towards making that possible. \n Rover.com \n Sentry \n Stream \n Machinalis Many thanks to all our wonderful sponsors , and in particular to our premium backers, Rover , Sentry , Stream , and Machinalis .", + "text": "REST framework is a collaboratively funded project . If you use\nREST framework commercially we strongly encourage you to invest in its\ncontinued development by signing up for a paid plan . The initial aim is to provide a single full-time position on REST framework. Every single sign-up makes a significant impact towards making that possible. \n Rover.com \n Sentry \n Stream \n Machinalis \n Rollbar Many thanks to all our wonderful sponsors , and in particular to our premium backers, Rover , Sentry , Stream , Machinalis , and Rollbar .", "title": "Funding" }, { @@ -52,7 +52,7 @@ }, { "location": "/#support", - "text": "For support please see the REST framework discussion group , try the #restframework channel on irc.freenode.net , search the IRC archives , or raise a question on Stack Overflow , making sure to include the 'django-rest-framework' tag. Paid support is available from DabApps , and can include work on REST framework core, or support with building your REST framework API. Please contact DabApps if you'd like to discuss commercial support options. For updates on REST framework development, you may also want to follow the author on Twitter. Follow @_tomchristie !function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=\"//platform.twitter.com/widgets.js\";fjs.parentNode.insertBefore(js,fjs);}}(document,\"script\",\"twitter-wjs\");", + "text": "For support please see the REST framework discussion group , try the #restframework channel on irc.freenode.net , search the IRC archives , or raise a question on Stack Overflow , making sure to include the 'django-rest-framework' tag. For priority support please sign up for a professional or premium sponsorship plan . For updates on REST framework development, you may also want to follow the author on Twitter. Follow @_tomchristie !function(d,s,id){var js,fjs=d.getElementsByTagName(s)[0];if(!d.getElementById(id)){js=d.createElement(s);js.id=id;js.src=\"//platform.twitter.com/widgets.js\";fjs.parentNode.insertBefore(js,fjs);}}(document,\"script\",\"twitter-wjs\");", "title": "Support" }, { @@ -5257,7 +5257,7 @@ }, { "location": "/topics/funding/", - "text": "// Imperfect, but easier to fit in with the existing docs build.\n// Hyperlinks should point directly to the \"fund.\" subdomain, but this'll\n// handle the nav bar links without requiring any docs build changes for the moment.\nif (window.location.hostname == \"www.django-rest-framework.org\") {\n window.location.replace(\"https://fund.django-rest-framework.org/topics/funding/\");\n}\n\n\n\n\n\n.promo li a {\n float: left;\n width: 130px;\n height: 20px;\n text-align: center;\n margin: 10px 30px;\n padding: 150px 0 0 0;\n background-position: 0 50%;\n background-size: 130px auto;\n background-repeat: no-repeat;\n font-size: 120%;\n color: black;\n}\n.promo li {\n list-style: none;\n}\n.chart {\n background-color: #e3e3e3;\n background: -webkit-linear-gradient(top, #fff 0, #e3e3e3 100%);\n border: 1px solid #E6E6E6;\n border-radius: 5px;\n box-shadow: 0px 0px 2px 0px rgba(181, 181, 181, 0.3);\n padding: 40px 0px 5px;\n position: relative;\n text-align: center;\n width: 97%;\n min-height: 255px;\n position: relative;\n top: 37px;\n margin-bottom: 20px\n}\n.quantity {\n text-align: center\n}\n.dollar {\n font-size: 19px;\n position: relative;\n top: -18px;\n}\n.price {\n font-size: 49px;\n}\n.period {\n font-size: 17px;\n position: relative;\n top: -8px;\n margin-left: 4px;\n}\n.plan-name {\n text-align: center;\n font-size: 20px;\n font-weight: 400;\n color: #777;\n border-bottom: 1px solid #d5d5d5;\n padding-bottom: 15px;\n width: 90%;\n margin: 0 auto;\n margin-top: 8px;\n}\n.specs {\n margin-top: 20px;\n min-height: 130px;\n}\n.specs.freelancer {\n min-height: 0px;\n}\n.spec {\n font-size: 15px;\n color: #474747;\n text-align: center;\n font-weight: 300;\n margin-bottom: 13px;\n}\n.variable {\n color: #1FBEE7;\n font-weight: 400;\n}\nform.signup {\n margin-top: 35px\n}\n.clear-promo {\n padding-top: 30px\n}\n#main-content h1:first-of-type {\n margin: 0 0 50px;\n font-size: 60px;\n font-weight: 200;\n text-align: center\n}\n#main-content {\n padding-top: 10px; line-height: 23px\n}\n#main-content li {\n line-height: 23px\n}\n\n\n\n\nFunding\n\n\n\n\nAs a direct result of \na successful Mozilla grant application\n, I will be leaving my current role at \nDabApps\n, and attempting to secure a sustainable business model for REST framework development. I need your help in order to make this work.\n\n\n Tom Christie\n\n\n\n\nIf you use REST framework commercially we strongly encourage you to invest in its continued development by signing up for a paid plan.\n\n\nWe believe that collaboratively funded software can offer outstanding returns on investment, by encouraging our users to collectively share the cost of development.\n\n\nSigning up for a paid plan will:\n\n\n\n\nDirectly contribute to faster releases, more features, and higher quality software.\n\n\nAllow more time to be invested in documentation, issue triage, and community support.\n\n\nSafeguard the future development of REST framework.\n\n\n\n\nREST framework continues to be open-source and permissively licensed, but we firmly believe it is in the commercial best-interest for users of the project to invest in its ongoing development.\n\n\n\n\nMaking the business case\n\n\nOur \nsuccessful Kickstarter campaign\n demonstrates the impressive cost-reward ratio of shared funding of open-source software.\n\n\nWith \ntypical corporate fundings of just \u00a3100-\u00a31000 per organization\n we successfully delivered:\n\n\n\n\nThe comprehensive serializer redesign, and \nversion 3.0 release\n.\n\n\nOngoing triage and community support, \nclosing over 1600 tickets\n.\n\n\nSubstantial improvements to the Browsable API.\n\n\nThe admin interface.\n\n\nA new pagination API including offset/limit and cursor pagination implementations, plus on-page controls.\n\n\nA versioning API, including URL-based and header-based versioning schemes.\n\n\nSupport for customizable exception handling.\n\n\nSupport for Django's PostgreSQL HStoreField, ArrayField and JSONField.\n\n\nTemplated HTML form support, including HTML forms with nested list and objects.\n\n\nInternationalization support for API responses, currently with 27 languages.\n\n\nThe metadata APIs for handling \nOPTIONS\n requests and schema endpoints.\n\n\nNumerous minor improvements and better quality throughout the codebase.\n\n\n\n\nThis incredible level of return on investment is \nonly possible through collaboratively funded models\n, which is why we believe that supporting our paid plans is in everyone's best interest.\n\n\nSign up for a paid plan today, and help ensure that REST framework becomes a sustainable, full-time funded project.\n\n\n\n\nFreelancer plan\n\n\nThis subscription is recommended for freelancers and other individuals with an interest in seeing REST framework continue to\nimprove.\n\n\nIf you are using REST framework as an full-time employee, consider recommending that your company takes out a \ncorporate\nplan\n.\n\n\n\n \n\n \n\n \n\n \n{{ symbol }}\n\n \n{{ rates.personal1 }}\n\n \n/month{% if vat %} +VAT{% endif %}\n\n \n\n \nFreelancer\n\n \n\n \n\n Support ongoing development\n \n\n \n\n Credited on the site\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n\n \n\n\n\n\n\n\nBilling is monthly and you can cancel at any time.\n\n\n\n\nCorporate plans\n\n\nThese subscriptions are recommended for companies and organizations using REST framework either publicly or privately.\n\n\nIn exchange for funding you'll also receive advertising space on our site, allowing you to \npromote your company or product to many tens of thousands of developers worldwide\n.\n\n\nOur professional and premium plans also include \npriority support\n. At any time your engineers can escalate an issue or discussion group thread, and we'll ensure it gets a guaranteed response within the next working day.\n\n\n\n \n\n \n\n \n\n \n{{ symbol }}\n\n \n{{ rates.corporate1 }}\n\n \n/month{% if vat %} +VAT{% endif %}\n\n \n\n \nBasic\n\n \n\n \n\n Support ongoing development\n \n\n \n\n \nFunding page\n ad placement\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n\n \n\n \n\n \n\n \n{{ symbol }}\n\n \n{{ rates.corporate2 }}\n\n \n/month{% if vat %} +VAT{% endif %}\n\n \n\n \nProfessional\n\n \n\n \n\n Support ongoing development\n \n\n \n\n \nSidebar\n ad placement\n \n\n \n\n \nPriority support\n for your engineers\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n\n \n\n \n\n \n\n \n{{ symbol }}\n\n \n{{ rates.corporate3 }}\n\n \n/month{% if vat %} +VAT{% endif %}\n\n \n\n \nPremium\n\n \n\n \n\n Support ongoing development\n \n\n \n\n \nHomepage\n ad placement\n \n\n \n\n \nSidebar\n ad placement\n \n\n \n\n \nPriority support\n for your engineers\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n\n \n\n\n\n\n\n\nBilling is monthly and you can cancel at any time.\n\n\nOnce you've signed up I'll contact you via email and arrange your ad placements on the site.\n\n\nFor further enquires please contact \ntom@tomchristie.com\n.\n\n\n\n\nAccountability\n\n\nIn order to ensure that I can be fully focused on trying to secure a sustainable\n\n well-funded open source business I will be leaving my current role at \nDabApps\n\nat the end of May 2016.\n\n\nI have formed a UK limited company, \nEncode\n, which will\nact as the business entity behind REST framework. I will be issuing monthly reports\nfrom Encode on progress both towards the \nMozilla grant\n, and for development time\nfunded via the REST framework paid plans.\n\n\n\n\n\n\n\n\n #mc_embed_signup{background:#fff; clear:left; font:14px Helvetica,Arial,sans-serif; }\n / Add your own MailChimp form style overrides in your site stylesheet or in this style block.\n We recommend moving this block and the preceding CSS link to the HEAD of your HTML file. /\n\n\n\n\n\n\n \n\n \nStay up to date, with our monthly progress reports...\n\n\n\n \nEmail Address \n\n \n\n\n\n \n\n \n\n \n\n \n \n\n \n\n \n\n \n\n\n\n\n\n\n(function($) {window.fnames = new Array(); window.ftypes = new Array();fnames[0]='EMAIL';ftypes[0]='email';fnames[1]='FNAME';ftypes[1]='text';fnames[2]='LNAME';ftypes[2]='text';}(jQuery));var $mcj = jQuery.noConflict(true);\n\n\n\n\n\n\nOur sponsors", + "text": "// Imperfect, but easier to fit in with the existing docs build.\n// Hyperlinks should point directly to the \"fund.\" subdomain, but this'll\n// handle the nav bar links without requiring any docs build changes for the moment.\nif (window.location.hostname == \"www.django-rest-framework.org\") {\n window.location.replace(\"https://fund.django-rest-framework.org/topics/funding/\");\n}\n\n\n\n\n\n.promo li a {\n float: left;\n width: 130px;\n height: 20px;\n text-align: center;\n margin: 10px 30px;\n padding: 150px 0 0 0;\n background-position: 0 50%;\n background-size: 130px auto;\n background-repeat: no-repeat;\n font-size: 120%;\n color: black;\n}\n.promo li {\n list-style: none;\n}\n.chart {\n background-color: #e3e3e3;\n background: -webkit-linear-gradient(top, #fff 0, #e3e3e3 100%);\n border: 1px solid #E6E6E6;\n border-radius: 5px;\n box-shadow: 0px 0px 2px 0px rgba(181, 181, 181, 0.3);\n padding: 40px 0px 5px;\n position: relative;\n text-align: center;\n width: 97%;\n min-height: 255px;\n position: relative;\n top: 37px;\n margin-bottom: 20px\n}\n.quantity {\n text-align: center\n}\n.dollar {\n font-size: 19px;\n position: relative;\n top: -18px;\n}\n.price {\n font-size: 49px;\n}\n.period {\n font-size: 17px;\n position: relative;\n top: -8px;\n margin-left: 4px;\n}\n.plan-name {\n text-align: center;\n font-size: 20px;\n font-weight: 400;\n color: #777;\n border-bottom: 1px solid #d5d5d5;\n padding-bottom: 15px;\n width: 90%;\n margin: 0 auto;\n margin-top: 8px;\n}\n.specs {\n margin-top: 20px;\n min-height: 130px;\n}\n.specs.freelancer {\n min-height: 0px;\n}\n.spec {\n font-size: 15px;\n color: #474747;\n text-align: center;\n font-weight: 300;\n margin-bottom: 13px;\n}\n.variable {\n color: #1FBEE7;\n font-weight: 400;\n}\nform.signup {\n margin-top: 35px\n}\n.clear-promo {\n padding-top: 30px\n}\n#main-content h1:first-of-type {\n margin: 0 0 50px;\n font-size: 60px;\n font-weight: 200;\n text-align: center\n}\n#main-content {\n padding-top: 10px; line-height: 23px\n}\n#main-content li {\n line-height: 23px\n}\n\n\n\n\nFunding\n\n\n\n\nAs a direct result of \na successful Mozilla grant application\n, I will be leaving my current role at \nDabApps\n, and attempting to secure a sustainable business model for REST framework development. I need your help in order to make this work.\n\n\n Tom Christie\n\n\n\n\nIf you use REST framework commercially we strongly encourage you to invest in its continued development by signing up for a paid plan.\n\n\nWe believe that collaboratively funded software can offer outstanding returns on investment, by encouraging our users to collectively share the cost of development.\n\n\nSigning up for a paid plan will:\n\n\n\n\nDirectly contribute to faster releases, more features, and higher quality software.\n\n\nAllow more time to be invested in documentation, issue triage, and community support.\n\n\nSafeguard the future development of REST framework.\n\n\n\n\nREST framework continues to be open-source and permissively licensed, but we firmly believe it is in the commercial best-interest for users of the project to invest in its ongoing development.\n\n\n\n\nMaking the business case\n\n\nOur \nsuccessful Kickstarter campaign\n demonstrates the impressive cost-reward ratio of shared funding of open-source software.\n\n\nWith \ntypical corporate fundings of just \u00a3100-\u00a31000 per organization\n we successfully delivered:\n\n\n\n\nThe comprehensive serializer redesign, and \nversion 3.0 release\n.\n\n\nOngoing triage and community support, \nclosing over 1600 tickets\n.\n\n\nSubstantial improvements to the Browsable API.\n\n\nThe admin interface.\n\n\nA new pagination API including offset/limit and cursor pagination implementations, plus on-page controls.\n\n\nA versioning API, including URL-based and header-based versioning schemes.\n\n\nSupport for customizable exception handling.\n\n\nSupport for Django's PostgreSQL HStoreField, ArrayField and JSONField.\n\n\nTemplated HTML form support, including HTML forms with nested list and objects.\n\n\nInternationalization support for API responses, currently with 27 languages.\n\n\nThe metadata APIs for handling \nOPTIONS\n requests and schema endpoints.\n\n\nNumerous minor improvements and better quality throughout the codebase.\n\n\n\n\nThis incredible level of return on investment is \nonly possible through collaboratively funded models\n, which is why we believe that supporting our paid plans is in everyone's best interest.\n\n\nSign up for a paid plan today, and help ensure that REST framework becomes a sustainable, full-time funded project.\n\n\n\n\nFreelancer plan\n\n\nThis subscription is recommended for freelancers and other individuals with an interest in seeing REST framework continue to\nimprove.\n\n\nIf you are using REST framework as an full-time employee, consider recommending that your company takes out a \ncorporate\nplan\n.\n\n\n\n \n\n \n\n \n\n \n{{ symbol }}\n\n \n{{ rates.personal1 }}\n\n \n/month{% if vat %} +VAT{% endif %}\n\n \n\n \nFreelancer\n\n \n\n \n\n Support ongoing development\n \n\n \n\n Credited on the site\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n\n \n\n\n\n\n\n\nBilling is monthly and you can cancel at any time.\n\n\n\n\nCorporate plans\n\n\nThese subscriptions are recommended for companies and organizations using REST framework either publicly or privately.\n\n\nIn exchange for funding you'll also receive advertising space on our site, allowing you to \npromote your company or product to many tens of thousands of developers worldwide\n.\n\n\nOur professional and premium plans also include \npriority support\n. At any time your engineers can escalate an issue or discussion group thread, and we'll ensure it gets a guaranteed response within the next working day.\n\n\n\n \n\n \n\n \n\n \n{{ symbol }}\n\n \n{{ rates.corporate1 }}\n\n \n/month{% if vat %} +VAT{% endif %}\n\n \n\n \nBasic\n\n \n\n \n\n Support ongoing development\n \n\n \n\n \nFunding page\n ad placement\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n\n \n\n \n\n \n\n \n{{ symbol }}\n\n \n{{ rates.corporate2 }}\n\n \n/month{% if vat %} +VAT{% endif %}\n\n \n\n \nProfessional\n\n \n\n \n\n Support ongoing development\n \n\n \n\n \nSidebar\n ad placement\n \n\n \n\n \nPriority support\n for your engineers\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n\n \n\n \n\n \n\n \n{{ symbol }}\n\n \n{{ rates.corporate3 }}\n\n \n/month{% if vat %} +VAT{% endif %}\n\n \n\n \nPremium\n\n \n\n \n\n Support ongoing development\n \n\n \n\n \nHomepage\n ad placement\n \n\n \n\n \nSidebar\n ad placement\n \n\n \n\n \nPriority support\n for your engineers\n \n\n \n\n \n\n \n\n \n\n\n\n \n\n \n\n \n\n\n\n\n\n\nBilling is monthly and you can cancel at any time.\n\n\nOnce you've signed up I'll contact you via email and arrange your ad placements on the site.\n\n\nFor further enquires please contact \nfunding@django-rest-framework.org\n.\n\n\n\n\nAccountability\n\n\nIn order to ensure that I can be fully focused on trying to secure a sustainable\n\n well-funded open source business I will be leaving my current role at \nDabApps\n\nat the end of May 2016.\n\n\nI have formed a UK limited company, \nEncode\n, which will\nact as the business entity behind REST framework. I will be issuing monthly reports\nfrom Encode on progress both towards the \nMozilla grant\n, and for development time\nfunded via the REST framework paid plans.\n\n\n\n\n\n\n\n\n #mc_embed_signup{background:#fff; clear:left; font:14px Helvetica,Arial,sans-serif; }\n / Add your own MailChimp form style overrides in your site stylesheet or in this style block.\n We recommend moving this block and the preceding CSS link to the HEAD of your HTML file. /\n\n\n\n\n\n\n \n\n \nStay up to date, with our monthly progress reports...\n\n\n\n \nEmail Address \n\n \n\n\n\n \n\n \n\n \n\n \n \n\n \n\n \n\n \n\n\n\n\n\n\n(function($) {window.fnames = new Array(); window.ftypes = new Array();fnames[0]='EMAIL';ftypes[0]='email';fnames[1]='FNAME';ftypes[1]='text';fnames[2]='LNAME';ftypes[2]='text';}(jQuery));var $mcj = jQuery.noConflict(true);\n\n\n\n\n\n\nOur sponsors", "title": "Funding" }, { @@ -5277,7 +5277,7 @@ }, { "location": "/topics/funding/#corporate-plans", - "text": "These subscriptions are recommended for companies and organizations using REST framework either publicly or privately. In exchange for funding you'll also receive advertising space on our site, allowing you to promote your company or product to many tens of thousands of developers worldwide . Our professional and premium plans also include priority support . At any time your engineers can escalate an issue or discussion group thread, and we'll ensure it gets a guaranteed response within the next working day. \n \n \n \n {{ symbol }} \n {{ rates.corporate1 }} \n /month{% if vat %} +VAT{% endif %} \n \n Basic \n \n \n Support ongoing development\n \n \n Funding page ad placement\n \n \n \n \n \n \n \n \n \n \n {{ symbol }} \n {{ rates.corporate2 }} \n /month{% if vat %} +VAT{% endif %} \n \n Professional \n \n \n Support ongoing development\n \n \n Sidebar ad placement\n \n \n Priority support for your engineers\n \n \n \n \n \n \n \n \n \n \n {{ symbol }} \n {{ rates.corporate3 }} \n /month{% if vat %} +VAT{% endif %} \n \n Premium \n \n \n Support ongoing development\n \n \n Homepage ad placement\n \n \n Sidebar ad placement\n \n \n Priority support for your engineers\n \n \n \n \n \n \n \n Billing is monthly and you can cancel at any time. Once you've signed up I'll contact you via email and arrange your ad placements on the site. For further enquires please contact tom@tomchristie.com .", + "text": "These subscriptions are recommended for companies and organizations using REST framework either publicly or privately. In exchange for funding you'll also receive advertising space on our site, allowing you to promote your company or product to many tens of thousands of developers worldwide . Our professional and premium plans also include priority support . At any time your engineers can escalate an issue or discussion group thread, and we'll ensure it gets a guaranteed response within the next working day. \n \n \n \n {{ symbol }} \n {{ rates.corporate1 }} \n /month{% if vat %} +VAT{% endif %} \n \n Basic \n \n \n Support ongoing development\n \n \n Funding page ad placement\n \n \n \n \n \n \n \n \n \n \n {{ symbol }} \n {{ rates.corporate2 }} \n /month{% if vat %} +VAT{% endif %} \n \n Professional \n \n \n Support ongoing development\n \n \n Sidebar ad placement\n \n \n Priority support for your engineers\n \n \n \n \n \n \n \n \n \n \n {{ symbol }} \n {{ rates.corporate3 }} \n /month{% if vat %} +VAT{% endif %} \n \n Premium \n \n \n Support ongoing development\n \n \n Homepage ad placement\n \n \n Sidebar ad placement\n \n \n Priority support for your engineers\n \n \n \n \n \n \n \n Billing is monthly and you can cancel at any time. Once you've signed up I'll contact you via email and arrange your ad placements on the site. For further enquires please contact funding@django-rest-framework.org .", "title": "Corporate plans" }, { diff --git a/sitemap.xml b/sitemap.xml index caaddf6b5..dc6068389 100644 --- a/sitemap.xml +++ b/sitemap.xml @@ -4,7 +4,7 @@Billing is monthly and you can cancel at any time.
Once you've signed up I'll contact you via email and arrange your ad placements on the site.
-For further enquires please contact tom@tomchristie.com.
+For further enquires please contact funding@django-rest-framework.org.
In order to ensure that I can be fully focused on trying to secure a sustainable