Bug 1569130 - Explain in the API doc that Bugzilla returns a 302 redirect when the...

diff --git a/docs/en/rst/api/core/v1/general.rst b/docs/en/rst/api/core/v1/general.rst
index 6227e18257c4a4da90c22aee3e9ad552960dfda6..c4d0c2b4f948b97caae1b6a2f0113c449bde8ca5 100644 (file)
--- a/docs/en/rst/api/core/v1/general.rst
+++ b/docs/en/rst/api/core/v1/general.rst
@@ -52,6 +52,13 @@ The error contents look similar to:
      "code": 123
    }
 
+To protect the application from large requests, Bugzilla returns a 302 redirect
+to the homepage when your query string is too long. The current limit is 10 KB,
+which can accept roughly 1,000 bug IDs in the ``id`` parameter for the
+``/rest/bug`` method, but it could be smaller or may lead to a 414 URI Too Long
+HTTP error depending on the server configuration. Split your query into multiple
+requests if you encounter the issue.
+
 Common Data Types
 -----------------