mirror of
https://github.com/servalproject/serval-dna.git
synced 2024-12-29 17:38:59 +00:00
79 lines
2.3 KiB
Markdown
79 lines
2.3 KiB
Markdown
|
MeshMB REST API
|
||
|
|
===============
|
||
|
|
[Serval Project][], February 2016
|
||
|
|
|
||
|
|
Introduction
|
||
|
|
------------
|
||
|
|
|
||
|
|
[MeshMB][] is a service in the [Serval Mesh network][] that provides
|
||
|
|
distributed one-to-all messaging using [Rhizome][] as transport.
|
||
|
|
|
||
|
|
The [Serval DNA][] daemon that runs on every node gives applications access to
|
||
|
|
the MeshMB service via the **MeshMB REST API** described in this document.
|
||
|
|
|
||
|
|
### Basic concepts
|
||
|
|
|
||
|
|
#### Feed
|
||
|
|
|
||
|
|
An unencrypted rhizome journal. With the same internal format as a MeshMS message ply.
|
||
|
|
|
||
|
|
Each feed has a name, set in the rhizome manifest.
|
||
|
|
|
||
|
|
The Bundle ID of the feed, is the author of the bundle. In other words,
|
||
|
|
the bundle secret is the same secret stored in the serval keyring to represent an identity.
|
||
|
|
|
||
|
|
### POST /restful/meshmb/ID/sendmessage
|
||
|
|
|
||
|
|
Append a new message to the feed.
|
||
|
|
|
||
|
|
### GET /restful/meshmb/FEEDID/messagelist.json
|
||
|
|
|
||
|
|
List the messages in any feed.
|
||
|
|
|
||
|
|
### GET /restful/meshmb/FEEDID/newsince[/TOKEN]/messagelist.json
|
||
|
|
|
||
|
|
List messages from a feed as they arrive.
|
||
|
|
|
||
|
|
### GET /restful/meshmb/ID/feedlist.json
|
||
|
|
|
||
|
|
List the feeds that you have subscribed to.
|
||
|
|
|
||
|
|
### GET /restful/meshmb/ID/activity.json
|
||
|
|
|
||
|
|
List the messages of all subscribed feeds, threaded in the order they originally arrived.
|
||
|
|
|
||
|
|
### GET /restful/meshmb/ID/activity[/TOKEN]/activity.json
|
||
|
|
|
||
|
|
List the messages of all subscribed feeds, as they arrive.
|
||
|
|
|
||
|
|
### POST /restful/meshmb/ID/follow/FEEDID
|
||
|
|
|
||
|
|
Start following this Feed.
|
||
|
|
|
||
|
|
### POST /restful/meshmb/ID/ignore/FEEDID
|
||
|
|
|
||
|
|
Stop following this Feed.
|
||
|
|
|
||
|
|
-----
|
||
|
|
**Copyright 2015 Serval Project Inc.**
|
||
|
|
|
||
|
|
Available under the [Creative Commons Attribution 4.0 International licence][CC BY 4.0].
|
||
|
|
|
||
|
|
|
||
|
|
[Serval Project]: http://www.servalproject.org/
|
||
|
|
[CC BY 4.0]: ../LICENSE-DOCUMENTATION.md
|
||
|
|
[Serval Mesh network]: http://developer.servalproject.org/dokuwiki/doku.php?id=content:tech:mesh_network
|
||
|
|
[Serval DNA]: ../README.md
|
||
|
|
[REST-API]: ./REST-API.md
|
||
|
|
[MeshMS]: http://developer.servalproject.org/dokuwiki/doku.php?id=content:tech:meshms
|
||
|
|
[Rhizome]: ./REST-API-Rhizome.md
|
||
|
|
[200]: ./REST-API.md#200-ok
|
||
|
|
[201]: ./REST-API.md#201-created
|
||
|
|
[202]: ./REST-API.md#202-accepted
|
||
|
|
[400]: ./REST-API.md#400-bad-request
|
||
|
|
[404]: ./REST-API.md#404-not-found
|
||
|
|
[419]: ./REST-API.md#419-authentication-timeout
|
||
|
|
[422]: ./REST-API.md#422-unprocessable-entity
|
||
|
|
[423]: ./REST-API.md#423-locked
|
||
|
|
[500]: ./REST-API.md#500-server-error
|