From: Kohei Yoshino <kohei.yoshino@gmail.com>
Date: Thu, 1 Aug 2019 19:43:58 +0000 (-0400)
Subject: Bug 1569130 - Explain in the API doc that Bugzilla returns a 302 redirect when the... 
X-Git-Url: http://git.ipfire.org/?a=commitdiff_plain;h=e627bd8ec2ed63b566786a815f53abfcfc7f2187;p=thirdparty%2Fbugzilla.git

Bug 1569130 - Explain in the API doc that Bugzilla returns a 302 redirect when the query string is > 10 KB
---

diff --git a/docs/en/rst/api/core/v1/general.rst b/docs/en/rst/api/core/v1/general.rst
index 6227e1825..c4d0c2b4f 100644
--- 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
 -----------------