2.3 KiB
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.