Update docs for REST token support

docs/index.md

@@ -1,14 +1,6 @@
 The JSON API provides an easily parseable interface to [BioTorrents.de](https://biotorrents.de).
 Please use the navigation menu to find lists of endpoints, their arguments, and example responses.
 
-You must be logged in to use the API.
-This is done by sending a POST request to
-
-`https://biotorrents.de/login.php`
-
-with `username` and `password`
-and storing a cookie to be used to access the rest of the API.
-
 
 # Introduction
 
@@ -23,6 +15,10 @@ All the JSON returned is in the form
   "status": "success",
   "response": {
     # data
+  },
+  "info": {
+    "source": "BioTorrents.de",
+    "version": 1
   }
 }
 ```
@@ -31,6 +27,26 @@ If the request is invalid, or a problem occurs, the `status` will be `failure`.
 In this case the value of `response` is `undefined`.
 
 
+## Bearer token auth
+
+First, generate a token in your profile security settings and keep it safe.
+It's functionally a password and like a password, it can't be recovered later.
+Then POST an RFC 6750--compliant bearer token along with each GET api endpoint:
+
+```sh
+curl biotorrents.de/ajax.php?action=index \
+  -H "Accept: application/json" \
+  -H "Authorization: Bearer {token}"
+```
+
+
+## Cookie auth
+
+Please send a POST request to `https://biotorrents.de/login.php` with `username` and `password`,
+or acquire a cookie from a browser session using developer tools.
+Then store the cookie and use it to access the rest of the API.
+
+
 # Libraries
 
 These are the current public projects listed on the

docs/meta.md

@@ -199,6 +199,7 @@ Fetch the recent news and blogs.
 
 Either `id` or `name` is required.
 
+
 **Request**
 
 `ajax.php?action=wiki`
@@ -225,3 +226,68 @@ Either `id` or `name` is required.
     }
 }
 ```
+
+
+## Ontology
+
+Fetch a site metadata blueprint.
+
+
+**Request**
+
+`ajax.php?action=ontology`
+
+
+**Response**
+
+```json
+{
+    "status": "success",
+    "response": {
+        "SEQ": {
+            "ID": 1,
+            "Name": "Sequences",
+            "Icon": "/static/common/bioicons/sequences.png",
+            "Platforms": {
+                "0": "Complete Genomics",
+                "1": "cPAS-BGI/MGI",
+                "2": "Helicos",
+                "3": "Illumina HiSeq",
+                # etc.
+            },
+            "Formats": {
+                "NucleoSeq": {
+                    "BAM": {
+                        "0": "bam"
+                    },
+                    "CRAM": {
+                        "0": "cram"
+                    },
+                    "EMBL": {
+                        "0": "embl"
+                    },
+                    # etc.
+                "ProtSeq": {
+                    "ABI/Sciex": {
+                        "0": "t2d",
+                        "1": "wiff"
+                    },
+                    "APML": {
+                        "0": "apml"
+                    },		    
+                    # etc.
+                },
+		# etc.
+            },
+            "Description": "For data that's ACGT, ACGU, amino acid letters on disk."
+        },
+        "GRF": {
+            "ID": 2,
+            "Name": "Graphs",
+            "Icon": "/static/common/bioicons/graphs.png",
+            # etc.
+        },
+        # etc.
+    }
+}
+```

docs/torrents.md

@@ -172,10 +172,10 @@ The advanced search options are certain to change in the future.
 
 `ajax.php?action=browse`
 
-`&page=` — page to display (default: `1`)
-
 `&searchstr=` — string to search for
 
+`&page=` — page to display (default: `1`)
+
 `taglist`, `tags_type`, `order_by`, `order_way`, `filter_cat`, `freetorrent`, `vanityhouse`, `scene`, `haslog`, `releasetype`, `media`, `format`, `encoding`, `artistname`, `filelist`, `groupname`, `recordlabel`, `cataloguenumber`, `year`, `remastertitle`, `remasteryear`, `remasterrecordlabel`, `remastercataloguenumber` — as in advanced search
 
 

docs/users.md

@@ -520,25 +520,3 @@ switch ($Type) {
 
   # etc.
 ```
-
-
-## Password validate
-
-Is your current password acceptable?
-
-
-**Request**
-
-`ajax.php?action=password_validate`
-
-
-**Response**
-
-```json
-{
-    "status": "success",
-    "response": {
-        "pwValidate": "true"
-    }
-}
-```