diff --git a/src/api/ddoc/views.rst b/src/api/ddoc/views.rst index 8028ac6e..e0695510 100644 --- a/src/api/ddoc/views.rst +++ b/src/api/ddoc/views.rst @@ -915,135 +915,3 @@ Sending multiple queries to a view } ] } - -.. warning:: - Using POST to /{db}/_design/{ddoc}/_view/{view} is still supported and - allows you to get multiple query result to a view. This is described - below. However, this is not encouraged after using POST to - /{db}/_design/{ddoc}/_view/{view}/queries is introduced. - -.. http:post:: /{db}/_design/{ddoc}/_view/{view} - :synopsis: Returns results for the specified queries - - Executes multiple specified view queries against the view function - from the specified design document. - - :param db: Database name - :param ddoc: Design document name - :param view: View function name - - :
`. - - :>header Content-Type: - :mimetype:`application/json` - - :mimetype:`text/plain; charset=utf-8` - :>header ETag: Response signature - :>header Transfer-Encoding: ``chunked`` - - :>json array results: An array of result objects - one for each query. Each - result object contains the same fields as the response to a regular - :ref:`view request `. - - :code 200: Request completed successfully - :code 400: Invalid request - :code 401: Read permission required - :code 404: Specified database, design document or view is missed - :code 500: View function execution error - -**Request**: - -.. code-block:: http - - POST /recipes/_design/recipes/_view/by_title HTTP/1.1 - Content-Type: application/json - Accept: application/json - Host: localhost:5984 - - { - "queries": [ - { - "keys": [ - "meatballs", - "spaghetti" - ] - }, - { - "limit": 3, - "skip": 2 - } - ] - } - -**Response**: - -.. code-block:: http - - HTTP/1.1 200 OK - Cache-Control: must-revalidate - Content-Type: application/json - Date: Wed, 07 Sep 2016 11:17:07 GMT - ETag: "1H8RGBCK3ABY6ACDM7ZSC30QK" - Server: CouchDB (Erlang/OTP) - Transfer-Encoding: chunked - - { - "results" : [ - { - "offset": 0, - "rows": [ - { - "id": "SpaghettiWithMeatballs", - "key": "meatballs", - "value": 1 - }, - { - "id": "SpaghettiWithMeatballs", - "key": "spaghetti", - "value": 1 - }, - { - "id": "SpaghettiWithMeatballs", - "key": "tomato sauce", - "value": 1 - } - ], - "total_rows": 3 - }, - { - "offset" : 2, - "rows" : [ - { - "id" : "Adukiandorangecasserole-microwave", - "key" : "Aduki and orange casserole - microwave", - "value" : [ - null, - "Aduki and orange casserole - microwave" - ] - }, - { - "id" : "Aioli-garlicmayonnaise", - "key" : "Aioli - garlic mayonnaise", - "value" : [ - null, - "Aioli - garlic mayonnaise" - ] - }, - { - "id" : "Alabamapeanutchicken", - "key" : "Alabama peanut chicken", - "value" : [ - null, - "Alabama peanut chicken" - ] - } - ], - "total_rows" : 2667 - } - ] - }