commit ce91b9a6b8e48998e2df1ac082b1f7671929be8d
author Ian Maxon <imaxon@apache.org> Tue Jul 28 18:03:46 2015 -0700
committer Chris Hillery <ceej@lambda.nu> Tue Jul 28 18:54:07 2015 -0700
tree 9c16091d9b36325f4f7f283c0c8292c5d95bae3b
parent f41b34b6bf4c4d64c44dd188c81070db44c65378

Doc updates to HTTP API

-Rename "REST" API to HTTP API
-Minor documentation for /aql endpoint

Change-Id: I5c6520495752da312f4db7641fcfd14f7d63c829
Reviewed-on: https://asterix-gerrit.ics.uci.edu/331
Tested-by: Jenkins <jenkins@fulliautomatix.ics.uci.edu>
Reviewed-by: Chris Hillery <ceej@lambda.nu>

asterix-doc/src/site/markdown/api.md

diff --git a/asterix-doc/src/site/markdown/api.md b/asterix-doc/src/site/markdown/api.md
index 4d6edd2..4f7aca2 100644
--- a/asterix-doc/src/site/markdown/api.md
+++ b/asterix-doc/src/site/markdown/api.md
@@ -1,10 +1,11 @@
-# REST API to AsterixDB #
+# HTTP API to AsterixDB #
 
 ## <a id="toc">Table of Contents</a>
 
 * [DDL API](#DdlApi)
 * [Update API](#UpdateApi)
 * [Query API](#QueryApi)
+* [Mixed API](#AnyApi)
 * [Asynchronous Result API](#AsynchronousResultApi)
 * [Query Status API](#QueryStatusApi)
 * [Error Codes](#ErrorCodes)
@@ -179,6 +180,35 @@
         }
 
 
+## <a id="AnyApi">Mixed API</a> <font size="4"><a href="#toc">[Back to TOC]</a></font> ##
+
+*End point for any/mixed statement*
+
+Endpoint: _/aql_
+
+Parameters:
+
+<table>
+<tr>
+  <td>Parameter</td>
+  <td>Description</td>
+  <td>Required?</td>
+</tr>
+<tr>
+  <td>query</td>
+  <td>Query string to pass to ASTERIX for execution</td>
+  <td>Yes</td>
+</tr>
+<tr>
+  <td>mode</td>
+  <td>Indicate if call should be synchronous or asynchronous. mode = synchronous blocks the call until results are available; mode = asynchronous returns immediately with a handle that can be used later to check the query’s status and to fetch results when available</td>
+  <td>No. default mode = synchronous</td>
+</tr>
+</table>
+
+Similar to *_/update_* but allows any arbitrary AQL statement rather than only modifications.
+
+
 ## <a id="AsynchronousResultApi">Asynchronous Result API</a> <font size="4"><a href="#toc">[Back to TOC]</a></font> ##
 
 *End point to fetch the results of an asynchronous query*

asterix-doc/src/site/site.xml

diff --git a/asterix-doc/src/site/site.xml b/asterix-doc/src/site/site.xml
index 3e81a25..aaa73fc 100644
--- a/asterix-doc/src/site/site.xml
+++ b/asterix-doc/src/site/site.xml
@@ -81,7 +81,7 @@
       <item name="AQL Support of Similarity Queries" href="aql/similarity.html"/>
       <item name="Accessing External Data" href="aql/externaldata.html"/>
       <item name="Filter-Based LSM Index Acceleration" href="aql/filters.html"/>
-      <item name="REST API to AsterixDB" href="api.html"/>
+      <item name="HTTP API to AsterixDB" href="api.html"/>
     </menu>
 
     <menu ref="reports"/>