For authentication purposes either include an access_token
query parameter carrying the access token or set the Authorization
header to token dfg6wdg89wd65...
All methods will return a 401 status code if you failed to provide an access token, a 403 status code if the method exceeds the scope of your access token.
For the full set of Allowed methods, refer to the JSON API specification v1.0. Below follow Hive-specific additions and special cases.
The REST API interface provides full query support for filtering collections via waterline's query language, which should be easy to use if you have worked with MongoDB or similar databases / abstraction layers before.
GET /api/v1/documents?filter[title][contains]=foo
POST /api/v1/documents/2/snapshots
{"parent": "658deg654erh", "changes": "..."}
200 OK
{"id": "9834zf9obv", "parent": "658deg654erh", "contents": "hello world\n", "changes": "..."}
(Appends to the end of the document. Attachments must not be larger than 8MiB!)
POST /api/v1/documents/2/import
...
200 OK
{"message": "ok"}
GET /api/v1/snapshot/9834zf9obv/export?type=text/plain
200 OK
hello world\n