[aur-dev] [PATCH 4/6] Update RPC interface documentation

Lukas Fleischer lfleischer at archlinux.org
Sun Oct 4 09:41:47 UTC 2015

Signed-off-by: Lukas Fleischer <lfleischer at archlinux.org>
 doc/rpc.txt | 45 ++++++++++++++++++++++++---------------------
 1 file changed, 24 insertions(+), 21 deletions(-)

diff --git a/doc/rpc.txt b/doc/rpc.txt
index b379515..ee1fa1e 100644
--- a/doc/rpc.txt
+++ b/doc/rpc.txt
@@ -1,33 +1,36 @@
-aurweb RPC interface
+aurweb RPC Interface
-Allowed methods
+Package Search
-* `search`
-* `info`
-* `multiinfo`
-* `msearch`
+Package searches can be performed by issuing HTTP GET requests of the form
++/rpc/?v=5&type=search&search_by=_by_&arg=_keywords_+ where _by_ is either
+`name` (search by package name only), `name-desc` (search by package name and
+description) or `maintainer` (search by package maintainer) and _keywords_ is
+the search argument. The _search_by_ parameter can be skipped and defaults to
-Each method requires the following HTTP GET syntax:
+If a maintainer search is performed and the search argument is left empty, a
+list of orphan packages is returned.
-Where _methodname_ is the name of an allowed method, and _data_ is the argument
-to the call.
+Package Details
-If you need jsonp type callback specification, you can provide an additional
-variable _callback_.
+Package information can be obtained by issuing HTTP GET requests of the form
++/rpc/?v=5&type=info&arg[]=_pkg1_&arg[]=_pkg2_&...+ where _pkg1_, _pkg2_, ...
+are the names of packages to retrieve package details for.
-  `http://aur-url/rpc.php?type=search&arg=foobar`
+  `/rpc/?v=5&type=search&arg=foobar`
+`search` by maintainer::
+  `/rpc/?v=5&type=search&search_by=maintainer&arg=john`
+`search` with callback::
+  `/rpc/?v=5&type=search&arg=foobar&callback=jsonp1192244621103`
-  `http://aur-url/rpc.php?type=info&arg=foobar`
-  `http://aur-url/rpc.php?type=multiinfo&arg[]=foo&arg[]=bar`
-  `http://aur-url/rpc.php?type=msearch&arg=john`
-  `http://aur-url/rpc.php?type=search&arg=foobar&callback=jsonp1192244621103`
+  `/rpc/?v=5&type=info&arg[]=foobar`
+`info` with multiple packages::
+  `/rpc/?v=5&type=info&arg[]=foo&arg[]=bar`

More information about the aur-dev mailing list