Retrieve the Blogs moderation service document 

Before you can manage the entries and comments added to a blog or flagged as inappropriate, retrieve the moderation service document. You can use the links that it provides to locate the resources that await moderation approval.

The user authenticating the request must be the moderator of the Blogs application.

The service document provides two workspaces, one for entry moderation and one for comment moderation. If premoderation is enabled, then additional collections are also available.

Table 1. Atom API request details

Method Resource URI Description
GET Service document /moderation/atomsvc Accesses the moderation service document.

You must edit the contentApproval property in the contentreview-config.xml file to enable premoderation. See Manage content moderation and flagged content in the Administer applications section of the product documentation for more details.


Input parameters

None.


Output

A Blogs moderation service document in Atom Publishing Protocol format.

The following HTTP headers are returned:


Example

Input HTTP headers:

> GET /blogs/moderation/atomsvc?lang=en_us HTTP/1.1
> Host: enterprise.example.com
> Accept: */*

Response HTTP headers:

HTTP/1.1 200 OK
Content-Type: application/atomsvc+xml

Response content if the authenticated user is not a global moderator:

<service>
<atom:generator version="3.0" uri="http://www.ibm.com/xmlns/prod/sn">
 IBM Connections - Blogs
</atom:generator>
  <workspace>
    <atom:category term="entries-moderation" scheme="http://www.ibm.com/xmlns/prod/sn/workspace"/>
    <atom:title type="text">Moderation of blog entries</atom:title>
    <collection href="http://enterprise.example.com/blogs/home/api/approval/entries">
      <atom:title>Listing of pre-moderated content</atom:title>
      <atom:category term="approval-content" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept/>
    </collection>
    <collection href="http://enterprise.example.com/blogs/home/api/actions/approval/entries">
      <atom:title>Change pre-moderated content approval status</atom:title>
      <atom:category term="approval-action" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept>application/atom+xml;type=entry</accept>
    </collection>
  </workspace>
  <workspace>
    <atom:category term="comments-moderation" scheme="http://www.ibm.com/xmlns/prod/sn/workspace"/>
    <atom:title type="text">Moderation of blog comments</atom:title>
    <collection href="http://enterprise.example.com/blogs/home/api/approval/comments">
      <atom:title>Listing of pre-moderated content</atom:title>
      <atom:category term="approval-content" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept/>
    </collection>
    <collection href="http://enterprise.example.com/blogs/home/api/actions/approval/comments">
      <atom:title>Change pre-moderated content approval status</atom:title>
      <atom:category term="approval-action" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept>application/atom+xml;type=entry</accept>
    </collection>
  </workspace>
</service>

Response content if the authenticated user is a global moderator:

<service>
  <atom:generator 
   version="3.0" 
   uri="http://www.ibm.com/xmlns/prod/sn">IBM Connections - Blogs</atom:generator>
  <workspace>
    <atom:category term="entries-moderation" scheme="http://www.ibm.com/xmlns/prod/sn/workspace"/>
    <atom:title type="text">Moderation of blog entries</atom:title>
    <collection href="http://enterprise.example.com/blogs/home/api/approval/entries">
      <atom:title>Listing of pre-moderated content</atom:title>
      <atom:category term="approval-content" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept/>
    </collection>
    <collection href="http://enterprise.example.com/blogs/home/api/actions/approval/entries">
      <atom:title>Change pre-moderated content approval status</atom:title>
      <atom:category term="approval-action" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept>application/atom+xml;type=entry</accept>
    </collection>
    <collection href="http://enterprise.example.com/blogs/home/api/review/entries">
      <atom:title>Listing of post-moderated content</atom:title>
      <atom:category term="review-content" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept/>
    </collection>
    <collection href="http://enterprise.example.com/blogs/home/api/actions/review/entries">
      <atom:title>Change post-moderated content review status</atom:title>
      <atom:category term="review-action" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept>application/atom+xml;type=entry</accept>
    </collection>
  </workspace>
  <workspace>
    <atom:category term="comments-moderation" scheme="http://www.ibm.com/xmlns/prod/sn/workspace"/>
    <atom:title type="text">Moderation of blog comments</atom:title>
    <collection href="http://enterprise.example.com/blogs/home/api/approval/comments">
      <atom:title>Listing of pre-moderated content</atom:title>
      <atom:category term="approval-content" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept/>
    </collection>
    <collection href="http://enterprise.example.com/blogs/home/api/actions/approval/comments">
      <atom:title>Change pre-moderated content approval status</atom:title>
      <atom:category term="approval-action" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept>application/atom+xml;type=entry</accept>
    </collection>
    <collection href="http://enterprise.example.com/blogs/home/api/review/comments">
      <atom:title>Listing of post-moderated content</atom:title>
      <atom:category term="review-content" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept/>
    </collection>
    <collection href="http://enterprise.example.com/blogs/home/api/actions/review/comments">
      <atom:title>Change post-moderated content review status</atom:title>
      <atom:category term="review-action" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>
      <accept>application/atom+xml;type=entry</accept>
    </collection>
  </workspace>
</service>


Parent topic

Moderating blogs programmatically


Related tasks


Manage content moderation and flagged content


   

 

});