Notifications

Nodes can receive notifications about certain events from naming servers and other nodes. Notifications are sent through REST API of the receiving node. See Overview for the detailed description of notifications, their purpose and sending mechanism.

Notification packet

Notifications are sent in packets. The packet structure is described in Node API documentation. Each packet contains the type field, containing the type of the notification and notification field, containing the notification details in JSON form. The notification structure depends on the type. See the description below.

COMMENT_REACTION_ADDED

Reaction added to a comment owned by the receiver.

Type Field Comment
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node
String ownerName name of the reaction owner
boolean negative true, if the reaction is negative, false, if positive
int emoji reaction code, usually interpreted by clients as emoji code point
String postingHeading heading of the posting
String commentHeading heading of the comment

COMMENT_REACTION_DELETED

Reaction deleted from a comment owned by the receiver.

Type Field Comment
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node
String ownerName name of the reaction owner
boolean negative true, if the reaction is negative, false, if positive

COMMENT_REACTION_DELETED_ALL

All reactions deleted from a comment owned by the receiver.

Type Field Comment
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node

FEED_POSTING_ADDED

A new posting added in a feed the receiver is subscribed to.

Type Field Comment
String subscriberId subscriber ID of the receiving node on the sending node
String feedName name of the feed on the sending node
String postingId ID of the posting on the sending node

MENTION_COMMENT_ADDED

A mention of the receiver in a comment on the sending node added.

Type Field Comment
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node
String postingHeading heading of the posting
String commentOwnerName name of the comment owner
String commentHeading heading of the comment

MENTION_COMMENT_DELETED

A mention of the receiver in a comment on the sending node deleted.

Type Field Comment
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node

MENTION_POSTING_ADDED

A mention of the receiver in a posting on the sending node added.

Type Field Comment
String postingId ID of the posting on the sending node
String heading heading of the posting

MENTION_POSTING_DELETED

A mention of the receiver in a posting on the sending node deleted.

Type Field Comment
String postingId ID of the posting on the sending node

POSTING_COMMENT_ADDED

A comment added to the posting the receiver is subscribed to.

Type Field Comment
String subscriberId subscriber ID of the receiving node on the sending node
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node
String commentOwnerName name of the comment owner
String postingHeading heading of the posting
String commentHeading heading of the comment

POSTING_COMMENT_DELETED

A comment deleted from the posting the receiver is subscribed to.

Type Field Comment
String subscriberId subscriber ID of the receiving node on the sending node
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node
String commentOwnerName name of the comment owner

POSTING_COMMENTS_UPDATED

Comments have been updated at the posting the receiver is subscribed to.

Type Field Comment
String subscriberId subscriber ID of the receiving node on the sending node
String postingId ID of the posting on the sending node
int total updated total number of comments to the posting

POSTING_DELETED

Posting the receiver is subscribed to has been deleted.

Type Field Comment
String subscriberId subscriber ID of the receiving node on the sending node
String postingId ID of the posting on the sending node

POSTING_REACTIONS_UPDATED

Reactions have been updated at the posting the receiver is subscribed to.

Type Field Comment
String subscriberId subscriber ID of the receiving node on the sending node
String postingId ID of the posting on the sending node
ReactionTotalsInfo totals updated reaction totals of the posting

POSTING_UPDATED

Posting the receiver is subscribed to has been updated.

Type Field Comment
String subscriberId subscriber ID of the receiving node on the sending node
String postingId ID of the posting on the sending node

REPLY_COMMENT_ADDED

A reply to a comment of the receiver on the sending node added.

Type Field Comment
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node
String repliedToId ID of the comment on the sending node that is replied to
String postingHeading heading of the posting
String commentOwnerName name of the comment owner
String commentHeading heading of the comment
String repliedToHeading heading of the comment that is repliedTo

REPLY_COMMENT_DELETED

A reply to a comment of the receiver on the sending node deleted.

Type Field Comment
String postingId ID of the posting on the sending node
String commentId ID of the comment on the sending node
String repliedToId ID of the comment on the sending node that is replied to
String commentOwnerName name of the comment owner