[GitHub] jiangphcn commented on a change in pull request #243: Add description about new endpoint _dbs_info

[GitBox <gi...@apache.org>]

jiangphcn commented on a change in pull request #243: Add description about new endpoint _dbs_info
URL: https://github.com/apache/couchdb-documentation/pull/243#discussion_r164024641
 
 

 ##########
 File path: src/api/server/common.rst
 ##########
 @@ -208,6 +208,115 @@
            "locations"
         ]
 
+.. _api/server/dbs_info:
+
+==============
+``/_dbs_info``
+==============
+
+.. http:post:: /_dbs_info
+    :synopsis: Returns information of a list of the specified databases
+
+    Returns information of a list of the specified databases in the CouchDB
+    instance. This enables you to request information about multiple databases
+    in a single request, in place of multiple :get:`/{db}` requests.
+
+    :<header Accept: - :mimetype:`application/json`
+    :>header Content-Type: - :mimetype:`application/json`
+    :code 200: Request completed successfully
 
 Review comment:
   @flimzy Hey Jonathan, only `POST request` is supported yet. So there are no accepted query parameters. The reason of using `POST request` only instead of supporting `GET request` as well are to
   i) avoid the URL length limitations
   ii) avoids URL encoding work for the caller

----------------------------------------------------------------
This is an automated message from the Apache Git Service.
To respond to the message, please log on GitHub and use the
URL above to go to the specific comment.
 
For queries about this service, please contact Infrastructure at:
users@infra.apache.org


With regards,
Apache Git Services