Activity Stream Search provides the ability to follow a "topic", which is either a word or a term that contains several words. This topic will then be identified in the text of public
events, and these events will be delivered to the personal stream of whoever followed the topic (BUT only when this stream is delivered using the search index, as the DB flow does not consider followed topics).
Following/un-following a topic, or getting a list of followed topics, is done via the standard Connections Following API - /news/follow/atom/resources . For topics, we are adding a new source called topics and a new resource type called topic.
Follow a topic
In order to follow the topic my_topic
, post the following atom entry to /news/follow/atom/resources?source=topics
Un-follow a topic
Same as following a topic, but use DELETE instead of POST
Get a list of followed topics
Send a GET to /news/follow/atom/resources?source=topics
Valid topics to follow
For performance reasons, not any topic may be followed.
Trying to follow an invalid topic will result in an HTTP Bad Request error (status code 400).
A valid topic satisfies the following rules:
- Does not start with a whitespace character
- After every special character (e.g. #, &, !) there is a normal word.
- Contains no more than 3 words
Examples of valid topics:
- Lotus Connections
Examples of invalid topics:
- Lotus Connections Version 4.0