Merge pull request #657 from mozilla-services/move-retry-after-to-err…

…or-responses Move Retry-After to error responses
mozilla-services · Feb 18, 2016 · d2d2f8e · d2d2f8e
2 parents 5d7fe88 + f4fb124
commit d2d2f8e
Show file tree

Hide file tree

Showing 2 changed files with 14 additions and 7 deletions.
diff --git a/cliquet_docs/api/backoff.rst b/cliquet_docs/api/backoff.rst
@@ -32,10 +32,5 @@ requests.
 Retry-After indicators
 ======================
 
-A ``Retry-After`` header will be added to error responses (>=500),
-telling the client how many seconds it should wait before trying
-again.
-
-::
-
-    Retry-After: 30
+A ``Retry-After`` header will be added if response is an error (>=500).
+See more details about :ref:`error responses <error-responses>`.
diff --git a/cliquet_docs/api/errors.rst b/cliquet_docs/api/errors.rst
@@ -34,6 +34,18 @@ If the HTTP status is not OK (<200 or >=400), the response contains a JSON mappi
 Refer yourself to the ref:`set of errors codes <errors>`.
 
 
+Retry-After indicators
+======================
+
+A ``Retry-After`` header will be added to error responses (>=500),
+telling the client how many seconds it should wait before trying
+again.
+
+::
+
+    Retry-After: 30
+
+
 Precondition errors
 ===================