Blogger API

Conversant has support for the Blogger API in it's weblog XML-RPC interfaces. Blogger is another online tool for maintaining weblogs, and a number of people have built tools that use it's standard API for communicating adding posts to a weblog...so we've decided to support the API.

Radio Userland & Conversant

For instructions to set up Radio Userland to work with Conversant, see the support site.

Overview

Currently, five methods are supported:

• blogger.newPost
• blogger.editPost
• blogger.getPost
• blogger.getRecentPosts
• blogger.deletePost

Because there are differences in the way Blogger handles it's weblogs, please be sure to read this page carefully if you wish to use any tools that will post to Conversant via this API.

Overview

As with all XML-RPC call directed at Free-Conversant sites, use the following basic host information in your XML-RPC calls:

• rpcHost = www.free-conversant.com
• rpcPath = /RPC2
• rpcPort = 80

(Of course, adjust rpcHost to point to the domain that hosts your Conversant conversation.)

API Reference

blogger.newPost

Parameters:

• appkey : currently ignored
• blogId : blogId should be a string identifying the blog you wish to post to. This string will look like "zoneId|convId|pathToWeblog". pathToWeblog should be only the path that remains if you remove that base URL of the site...ie, if your weblog resides at "http://www.free-conversant.com/[mysite]/weblog", the pathToWeblog should be "weblog".
• username : the email address you use as a username for the site. This user must have privileges to post to the weblog as either the weblog owner, or a member of the owner group.
• password : the password you use for the site
• content : the text that will become the body of the message post
• publish : true/false. If false, a new message will be created in the conversation, but it will not actually be posted to the weblog. If true, it will be posted.

Returns:

• postId : postId is a unique identifier for the post created. It can be used with blogger.editPost to modify the post. postId will look like..."zoneId|convId|pathToWeblog|msgNum".

NOTE: Blogger doesn't support message subjects. There is a property of each weblog page available to set the value you wish to use for the subject of message posted via this API.

blogger.editPost

Parameters:

• appkey : currently ignored
• postId : postId is a unique identifier for the post created. It is the value returned by blogger.newPost. postId will look like..."zoneId|convId|pathToWeblog|msgNum".
• username : the email address you use as a username for the site. This user must have privileges to post to the weblog as either the weblog owner, or a member of the owner group.
• password : the password you use for the site
• content : the text that will become the body of the message post.
• publish : true/false. If true, and the message has not already been posted to the weblog, it will be added now.

Returns:

• true

blogger.getPost

Parameters:

• appkey : currently ignored
• postId : postId is a unique identifier for the post created. It is the value returned by blogger.newPost. postId will look like..."zoneId|convId|pathToWeblog|msgNum".
• username : the email address you use as a username for the site. This user must have privileges to post to the weblog as either the weblog owner, or a member of the owner group.
• password : the password you use for the site

Returns:

• struct containing values content ( message body ), userId, postId and dateCreated.

blogger.getRecentPosts

Parameters:

• appkey : currently ignored
• blogId : blogId should be a string identifying the blog you wish to post to. This string will look like "zoneId|convId|pathToWeblog". pathToWeblog should be only the path that remains if you remove that base URL of the site...ie, if your weblog resides at "http://www.free-conversant.com/[mysite]/weblog", the pathToWeblog should be "weblog".
• username : the email address you use as a username for the site. This user must have privileges to post to the weblog as either the weblog owner, or a member of the owner group.
• password : the password you use for the site
• numberOfPosts : the number of recent posts that you want returns

Returns:

• an array of structs, where each struct is one post. Each post is formatted exactly like the result of blogger.getPost (see above).

blogger.deletePost

Parameters:

• appkey : currently ignored
• postId : postId is a unique identifier for the post created. It is the value returned by blogger.newPost. postId will look like..."zoneId|convId|pathToWeblog|msgNum".
• username : the email address you use as a username for the site. This user must have privileges to post to the weblog as either the weblog owner, or a member of the owner group.
• password : the password you use for the site
• publish : true/false. Ignored.

Returns:

• true

Last update: 12/7/2002