Ticket #16079: handler404.patch

topics/http/urls.txt

@@ -257 +257 @@
 By default, this is ``'django.views.defaults.page_not_found'``. That default
 value should suffice.
 
+You can only set handler404 in the project-level URLconf. Setting it
+inside an application has no effect. To give a different 404 page for
+URLs that start with a specific prefix, it is possible to do that by
+checking the request path inside the ``handler404`` function. For
+example::
+
+    def handler404(request):
+        if request.get_full_path().startswith('/api/'):
+            # Provide a minimal 404 page for pages inside /api/
+            return HttpResponseNotFound('404 Not Found\n')
+        else:
+            return django.views.defaults.page_not_found(request)
+
 .. versionchanged:: 1.2
     Previous versions of Django only accepted strings representing import paths.
 
@@ -272 +285 @@
 By default, this is ``'django.views.defaults.server_error'``. That default
 value should suffice.
 
+See `handler404`_ for information about how to provide different error
+pages for a subset of the URLs.
+
 .. versionchanged:: 1.2
     Previous versions of Django only accepted strings representing import paths.