MetaWeblogAPI metaWeblog.getRecentPosts Method

MetaWeblogAPI metaWeblog.getRecentP...

Windows Live

The metaWeblog.getRecentPosts method returns the most recent draft and non-draft blog posts in descending order by publish date.

Syntax

public struct[] metaWeblog.getRecentPosts(string blogid,
string username,
string password,
int numberOfPosts);

Parameters

blogid [in]

The relationship name of the message container being edited. It is MyBlog in Wave 11, which is the user’s blog.

username [in]

The name of the user’s space.

password [in]

The user’s secret word.

numberOfPosts [in]

The number of posts to return. The maximum value is 20.

Returns

struct[] [out]

An array of structs that represents each post. Each struct will contain the following fields: title, description, postid, dateCreated, and categories. Each struct in the array has the following structure:

struct {
    string postid;
    DateTime dateCreated;
    string title;
    string description;
    string[] categories;
    bool publish;
}

Sample XML-RPC Request as XML

<methodCall> 
<methodName>metaWeblog.getRecentPosts</methodName>
<params>
<param>
<value>
<string>MyBlog</string>
</value>
</param>
<param>
<value>!spacename!</value>
</param>
<param>
<value>
<string>secretword</string>
</value>
<value>
<i4>1</i4>
</value>
</param>
</params>
</methodCall>

Sample XML-RPC Response as XML

<methodResponse> 
<params>
<param>
<value>
<array>
<data>
<value>
<struct>
<member>
<name>categories</name>
<value>
<array>
<data>
<value>Adventures</value>
</data>
</array>
</value>
</member>
<member>
<name>dateCreated</name>
<value>
<dateTime.iso8601>20030729T10:59:48</dateTime.iso8601>
</value>
</member>
<member>
<name>description</name>
<value>Dr. Quest is missing while on an expedition to find the Yeti. Jonny and his friends head to the Himalayas to find him, but run into another scientist who's determined to bring back the Yeti.
</value>
</member>
<member>
<name>link</name>
<value>http://blogs.law.harvard.edu/lydon/2003/07/18#a187</value>
</member>
<member>
<name>postid</name>
<value>
<i4>1829</i4>
</value>
</member>
<member>
<name>title</name>
<value>Expedition To Khumbu</value>
</member>
<member>
<name>publish</name>
<value>
<boolean>1</boolean>
</value>
</member>
</struct>
</value>
</data>
</array>
</value>
</param>
</params>
</methodResponse>