Community articleNavigating Blogs subscription API resources
Added by IBM contributorIBM on June 19, 2014
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Describes which feeds to use to get information about Blogs resources.
The following tables describe the subscription API resources that are directly and indirectly accessible from Blogs.

Table 1. Directly accessible publishing resources
Resource
URI
Description
All blogs feed
{homepage}/feed/blogs/atom
Lists all available blog definitions. You can perform the following operation:
  • GET feed of blog definition Atom entries

All blogs latest posts feed
{homepage}/feed/entries/atom
Lists most recent posts in all blogs. You can perform the following operation:
  • GET feed of blog post Atom entries

All blogs featured posts feed
{homepage}/feed/featured/atom
Lists the top 5 blog posts that have been most active within the last 2 weeks. You can perform the following operation:
  • GET feed of blog post Atom entries

All featured blogs feed
{homepage}/feed/featuredblogs/atom
Lists the 5 blogs that have been most active within the last two weeks. You can perform the following operation:
  • GET feed of blog Atom entries

All blogs latest comments feed
{homepage}/feed/comments/atom
Lists most recent comments to posts in all blogs. You can perform the following operation:
  • GET feed of blog comment Atom entries

All blogs tags category document
{homepage}/feed/tags/atom
Lists tags applied to all posts in all blogs. You can perform the following operation:
  • GET an Atom categories document listing the tags

Inappropriate content flags category document
{homepage}/feed/issuecategories/atom
Lists available categories used to report inappropriate content to administrator. You can perform the following operation:
  • GET an Atom categories document listing available tags for flagging inappropriate content

Blog posts feed
{handle}/feed/entries/atom
Lists all recent posts in the blog with the given handle. You can perform the following operation:
  • GET feed of blog post Atom entries

A person's default blog recent posts feed
roller-ui/feed/{emailaddress}
Lists all recent posts in the default blog of the user with the given email address. You can perform the following operation:
  • GET feed of blog post Atom entries

Blog comments feed
{handle}/feed/comments/atom
Lists all recent comments to all posts in the blog with the given handle. You can perform the following operation:
  • GET feed of blog comment Atom entries

Blog media link entries feed
{handle}/feed/media/atom
Lists all media uploaded to the blog with the given handle. You can perform the following operation:
  • GET feed of media link Atom entries

Blog tags category document
{handle}/feed/tags/atom
Lists the cloud of tags applied to all posts in the blog with the given handle. You can perform the following operation:
  • GET an Atom categories document listing the tags




Note:
  • {homepage} represents the blog handle of the blog configured to be the home page of the Blogs application. The handle is defined when the home page blog is created by the administrator.
  • {handle} represents the blog handle. A handle is specified when a blog is first created and is used in the construction of web addresses used to query the entries in a blog.

Table 2. Indirectly accessible publishing resources
Resource
Address found in
Description
Blog post comments feed
replies link in blog post entries
A feed that allows anyone to view the comments to a blog post. This is a subscription feed accessible to any user. You can perform the following operation:
  • GET feed of comments to this one blog post
See Getting a feed of the comments added to a blog.
Blog post comments collection
comments collection link in blog post entries
A collection that allows authenticated users to add a new comment to this post. You can perform the following operations:
  • GET feed of comments to this one blog post
  • POST new comment
See Creating comments.
Inappropriate Content reporting link
reports link in blog post entries reports link in blog comment entries
A link that allows users to report to the blog administrator that this post or comment contains inappropriate content. You can perform the following operation:
  • POST new blog issue report atom entry
See Flagging blog content as inappropriate.
Blog media file link
content element in blog media link entries
Any media file, such as a picture. You can perform the following operation:
  • GET a media file
See Media link content.