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:
- HTTP/1.1 200 OK. Indicates document was found and returned.
- Content-Type: application/atomsvc+xml. Indicates payload contains data in Atom Publishing service document format.
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+xmlResponse 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
});