aboutsummaryrefslogtreecommitdiffstats
path: root/docs/api-guide/throttling.md
diff options
context:
space:
mode:
authorTom Christie2014-11-03 14:36:06 +0000
committerTom Christie2014-11-03 14:36:06 +0000
commitb106ebd2c0a19107f12d5b87cfbe0083aaaa60b9 (patch)
tree736da30fadc813385cc2359caeb30a8ef5d422cb /docs/api-guide/throttling.md
parent650a91ac24cbd3e5b4ad5d7d7c6706fdf6160a78 (diff)
parent8861a7dfc757a88335048aa7bbccfc8a77850c48 (diff)
downloaddjango-rest-framework-b106ebd2c0a19107f12d5b87cfbe0083aaaa60b9.tar.bz2
Merge pull request #1800 from tomchristie/version-3.0
Version 3.0
Diffstat (limited to 'docs/api-guide/throttling.md')
-rw-r--r--docs/api-guide/throttling.md2
1 files changed, 2 insertions, 0 deletions
diff --git a/docs/api-guide/throttling.md b/docs/api-guide/throttling.md
index 832304f1..16a7457b 100644
--- a/docs/api-guide/throttling.md
+++ b/docs/api-guide/throttling.md
@@ -178,6 +178,8 @@ To create a custom throttle, override `BaseThrottle` and implement `.allow_reque
Optionally you may also override the `.wait()` method. If implemented, `.wait()` should return a recommended number of seconds to wait before attempting the next request, or `None`. The `.wait()` method will only be called if `.allow_request()` has previously returned `False`.
+If the `.wait()` method is implemented and the request is throttled, then a `Retry-After` header will be included in the response.
+
## Example
The following is an example of a rate throttle, that will randomly throttle 1 in every 10 requests.