[couchdb-documentation] 01/01: POST is not supported

[ii...@apache.org]

This is an automated email from the ASF dual-hosted git repository.

iilyak pushed a commit to branch rfc-014-pagination
in repository https://gitbox.apache.org/repos/asf/couchdb-documentation.git

commit bf3d28dc22f29ca80a94b5b433e107ab0743d1df
Author: ILYA Khlopotov <ii...@apache.org>
AuthorDate: Thu Apr 30 05:02:07 2020 -0700

    POST is not supported
---
 rfcs/014-pagination.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/rfcs/014-pagination.md b/rfcs/014-pagination.md
index 768c2a4..b6bf011 100644
--- a/rfcs/014-pagination.md
+++ b/rfcs/014-pagination.md
@@ -88,8 +88,17 @@ document are to be interpreted as described in
     "next": "/myddb/_all_docs?bookmark=12343tyekf3"
   ```
 
+## Limitations
+
+- The `first`/`next`/`last` keys in the response are represented as path which
+  includes the bookmark query key. This means the bookmark token size contributes
+  to total URI length and is subject to a max URL lenght (around 2000 characters).
+  This means storing `keys` in a bookmark is not an option. For that reason
+  `POST` method is not supported when pagination is enabled
+
 ## Semantics of the implementation
 
+- Only GET method would have pagination support
 - The bookmark would include information needed to ensure proper pagination
   without the need to repeat initial parameters of the request.
 - Don't use delayed responses when `bookmark` field is provided