Retrieving the Blogs service document
Added by IBM contributorIBM | Edited by IBM contributorPaul Bastide on December 21, 2015
Rate this article 1 starsRate this article 2 starsRate this article 3 starsRate this article 4 starsRate this article 5 stars

Before your applications can create or update information in a blog, you must retrieve the service document. You can use the links that it provides to locate the resources that you want to update.
If done properly, you will create a Blogs service document in Atom Publishing protocol format.

If the service document contains a workspace indicate a blog definition, the workspace will contains an identifier to indicate its category:

<atom:category scheme="http://www.ibm.com/xmlns/prod/sn/workspace" term="communityideationblog" /> // The blog is an ideation blog.

<atom:category scheme="http://www.ibm.com/xmlns/prod/sn/workspace" term="communityblog" /> //The blog is a community blog.

<atom:category scheme="http://www.ibm.com/xmlns/prod/sn/workspace" term="blog" /> // The blog is regular blog.

Method URI Description
GET /blogs/api Accesses a user's service document. The service document provides a list of workspaces, one for each blog the user owns or for which the user is an author, including any blogs or ideation blogs added to a community. It also provides a workspace for the My Blogs collection, which was introduced in version 2.0.
GET /blogs/services/atom Accesses a user's service document. The service document provides a list of workspaces, one for each blog the user owns or for which the user is an author. This service document is compatible with IBM® Connections version 1.0.x. It does not provide a workspace for the My Blogs collection.
Output
Content Type: application/atom+xml
Name Type Optional Description
Content-Type
string No application/atomsvc+xml. Indicates payload contains data in Atom Publishing Service Document format.
Code Description
200
OK. Indicates document was found and returned.
Examples
GET /blogs/api HTTP/1.1

	Host: blogs.enterprise.example.com


Response returned by the server
<service>

	<atom:generator version="4.0.0.0" uri="http://www.ibm.com/xmlns/prod/sn">

	IBM Connections - Blogs

	</atom:generator>

	<snx:BlogsHomepageHandle>homepage</snx:BlogsHomepageHandle>

	<workspace>

	<atom:title>Blogs</atom:title>

	<collection href="https://enterprise.example.com:443/blogs/homepage/api/blogs">

	<atom:title>My Blogs</atom:title>

	<atom:category term="blogs" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<accept>application/atom+xml;type=entry</accept>

	<categories fixed="yes"/>

	</collection>

	</workspace>

	<workspace>

	<atom:title>AJ6 community</atom:title>

	<atom:category term="communityblog" scheme="http://www.ibm.com/xmlns/prod/sn/workspace"/>

	<collection

	href="https://enterprise.example.com/blogs/3da0e102-40c6-4148-8a99-28a1a1ebe71a/api/entries">

	<atom:title>Weblog Entries</atom:title>

	<atom:category term="entries" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:entries-cfa8395b-8f26-47f5-9e5e-f63a8f3b1c52</atom:id>

	<accept>application/atom+xml;type=entry</accept>

	<categories

	fixed="no"

	href="https://enterprise.example.com/blogs/3da0e102-40c6-4148-8a99-28a1a1ebe71a/api/tags"/>

	</collection>

	<collection

	href="https://enterprise.example.com/blogs/3da0e102-40c6-4148-8a99-28a1a1ebe71a/api/media">

	<atom:title>Media Entries</atom:title>

	<atom:category term="media" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:media-cfa8395b-8f26-47f5-9e5e-f63a8f3b1c52</atom:id>

	<accept>image/jpeg</accept>

	<accept>image/gif</accept>

	<accept>image/png</accept>

	<categories fixed="yes"/>

	</collection>

	<collection

	href="https://enterprise.example.com/blogs/3da0e102-40c6-4148-8a99-28a1a1ebe71a/api/comments">

	<atom:title>Comment Entries</atom:title>

	<atom:category term="comments" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:comments-cfa8395b-8f26-47f5-9e5e-f63a8f3b1c52</atom:id>

	<accept>application/atom+xml;type=entry</accept>

	<categories fixed="yes"/>

	</collection>

	</workspace>

	<workspace>

	<atom:title>AJ6 community</atom:title>

	<atom:category term="ideationblog" scheme="http://www.ibm.com/xmlns/prod/sn/workspace"/>

	<atom:category

	term="open"

	scheme="http://www.ibm.com/xmlns/prod/sn/flags"

	label="Users can contribute new ideas or comment on or vote for existing ideas in this Ideation Blog."/>

	<collection

	href="https://enterprise.example.com/blogs/Wb84965b6309f_47e5_9148_c77c261bd52d/api/entries">

	<atom:title>Weblog Entries</atom:title>

	<atom:category term="entries" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:entries-143ec8c1-d582-4e4c-a263-fcc01d7cd03e</atom:id>

	<accept>application/atom+xml;type=entry</accept>

	<categories

	fixed="no"

	href="https://enterprise.example.com/blogs/Wb84965b6309f_47e5_9148_c77c261bd52d/api/tags"/>

	</collection>

	<collection

	href="https://enterprise.example.com/blogs/Wb84965b6309f_47e5_9148_c77c261bd52d/api/media">

	<atom:title>Media Entries</atom:title>

	<atom:category term="media" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:media-143ec8c1-d582-4e4c-a263-fcc01d7cd03e</atom:id>

	<accept>image/jpeg</accept>

	<accept>image/gif</accept>

	<accept>image/png</accept>

	<categories fixed="yes"/>

	</collection>

	<collection

	href="https://enterprise.example.com/blogs/Wb84965b6309f_47e5_9148_c77c261bd52d/api/comments">

	<atom:title>Comment Entries</atom:title>

	<atom:category term="comments" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:comments-143ec8c1-d582-4e4c-a263-fcc01d7cd03e</atom:id>

	<accept>application/atom+xml;type=entry</accept>

	<categories fixed="yes"/>

	</collection>

	</workspace>

	<workspace>

	<atom:title>AJ6 Blog</atom:title>

	<collection href="https://enterprise.example.com/blogs/aj6/api/entries">

	<atom:title>Weblog Entries</atom:title>

	<atom:category term="entries" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:entries-dffdc67d-68d1-4759-88ca-20be0afd8cff</atom:id>

	<accept>application/atom+xml;type=entry</accept>

	<categories fixed="no" href="https://enterprise.example.com/blogs/aj6/api/tags"/>

	</collection>

	<collection href="https://enterprise.example.com/blogs/aj6/api/media">

	<atom:title>Media Entries</atom:title>

	<atom:category term="media" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:media-dffdc67d-68d1-4759-88ca-20be0afd8cff</atom:id>

	<accept>image/jpeg</accept>

	<accept>image/gif</accept>

	<accept>image/png</accept>

	<categories fixed="yes"/>

	</collection>

	<collection href="https://enterprise.example.com/blogs/aj6/api/comments">

	<atom:title>Comment Entries</atom:title>

	<atom:category term="comments" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:comments-dffdc67d-68d1-4759-88ca-20be0afd8cff</atom:id>

	<accept>application/atom+xml;type=entry</accept>

	<categories fixed="yes"/>

	</collection>

	</workspace>

	<workspace>

	<atom:title>My Standard Blog</atom:title>

	<collection href="https://enterprise.example.com/blogs/myhomeblog/api/entries">

	<atom:title>Weblog Entries</atom:title>

	<atom:category term="entries" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:entries-c3cda0ac-cf5e-4d2c-ada1-bfa99368699b</atom:id>

	<accept>application/atom+xml;type=entry</accept>

	<categories fixed="no" href="https://enterprise.example.com/blogs/myhomeblog/api/tags"/>

	</collection>

	<collection href="https://enterprise.example.com/blogs/myhomeblog/api/media">

	<atom:title>Media Entries</atom:title>

	<atom:category term="media" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:media-c3cda0ac-cf5e-4d2c-ada1-bfa99368699b</atom:id>

	<accept>image/jpeg</accept>

	<accept>image/gif</accept>

	<accept>image/png</accept>

	<categories fixed="yes"/>

	</collection>

	<collection href="https://enterprise.example.com/blogs/myhomeblog/api/comments">

	<atom:title>Comment Entries</atom:title>

	<atom:category term="comments" scheme="http://www.ibm.com/xmlns/prod/sn/collection"/>

	<atom:id>urn:lsid:ibm.com:blogs:comments-c3cda0ac-cf5e-4d2c-ada1-bfa99368699b</atom:id>

	<accept>application/atom+xml;type=entry</accept>

	<categories fixed="yes"/>

	</collection>

	</workspace>

	</service>