http://rpc.cnblogs.com/metaweblog/webenh
在网上闲逛,突然对博客的接口感兴趣,经考察,多数博客都对metaWeblog Api 提供了支持,虽然windows live writer是好用,不过出于对这个接口的好奇,也想自己做个能发博客的小工具.
到处浏览资料,用了一个下午终于成功发布了一篇简陋版博客:)。其实很简单,方法对了很快就连上了。
MetaWeblog API中文说明
1、什么是MetaWeblog API?
MetaWeblog API(MWA)是一个Blog程序接口标准,允许外部程序来获取或者设置Blog的文字和熟悉。他建立在XMLRPC接口之上,并且已经有了很多的实现。
2、基本的函数规范
有三个基本的函数规范:
metaWeblog.newPost (blogid, username, password, struct, publish) 返回一个字符串,可能是Blog的ID。
metaWeblog.editPost (postid, username, password, struct, publish) 返回一个Boolean值,代表是否修改成功。
metaWeblog.getPost (postid, username, password) 返回一个Struct。其中blogid、username、password分别代表Blog的id(注释:如果你有两个Blog,blogid指定你需要编辑的blog)、用户名和密码。
一、要引用的DLL【网上提供的示例多包含了这个DLL】
二、要实现的数据结构
MetaWeblogCode【如不想看代码请自行折叠】
1 using System;
2 using CookComputing.XmlRpc;
3
4 namespace metaWeblogTest
5 {
6
7 #region 微软MSN网站 使用的 MetaWeblog API.
8 /// 这个结构代表用户的博客基本信息
9 /// </summary>
10 [XmlRpcMissingMapping(MappingAction.Ignore)]
11 public struct UserBlog
12 {
13 public string url;
14 public string blogid;
15 public string blogName;
16 }
17
18
19 /// <summary>
20 /// 这个结构代表用户信息
21 /// </summary>
22 [XmlRpcMissingMapping(MappingAction.Ignore)]
23 public struct UserInfo
24 {
25 public string url;
26 public string blogid;
27 public string blogName;
28 public string firstname;
29 public string lastname;
30 public string email;
31 public string nickname;
32 }
33
34
35 /// <summary>
36 /// 这个结构代表博客分类信息
37 /// 这后面的getCategories()方法会取到CATEGORY数据。
38 /// </summary>
39 [XmlRpcMissingMapping(MappingAction.Ignore)]
40 public struct Category
41 {
42 public string description;
43 public string title;
44 }
45
46 /// <summary> 47 /// 这个结构代表博客( 文章 )信息。 48 /// 这后面的 editPost()方法, getRecentPosts()方法 和 getPost()方法 会取倒POST数据 . 49 /// </summary> 50 [XmlRpcMissingMapping(MappingAction.Ignore)] 51 public struct Post 52 { 53 public DateTime dateCreated; 54 public string description; 55 public string title; 56 public string postid; 57 public string[] categories; 58 } 59 #endregion 60 61 62 #region 网站:http://msdn.microsoft.com/en-us/library/aa905670.aspx 63 ///// <summary> 64 ///// 微软MSN网站 使用的 MetaWeblog API. 65 //// 网站:http://msdn.microsoft.com/en-us/library/aa905670.aspx 66 ///// </summary> 67 public class M_MetaWeblog : XmlRpcClientProtocol 68 { 69 70 71 /// <summary> 72 /// Returns the most recent draft and non-draft blog posts sorted in descending order by publish date. 73 /// </summary> 74 /// <param name="blogid"> This should be the string MyBlog, which indicates that the post is being created in the user’s blog. </param> 75 /// <param name="username"> The name of the user’s space. </param> 76 /// <param name="password"> The user’s secret word. </param> 77 /// <param name="numberOfPosts"> The number of posts to return. The maximum value is 20. </param> 78 /// <returns></returns> 79 /// TODO:得到最近发布的帖子 80 [XmlRpcMethod("metaWeblog.getRecentPosts")] 81 public Post[] getRecentPosts( 82 string blogid, 83 string username, 84 string password, 85 int numberOfPosts) 86 { 87 88 return (Post[])this.Invoke("getRecentPosts", new object[] { blogid, username, password, numberOfPosts }); 89 } 90 91 92 /// <summary> 93 /// Posts a new entry to a blog. 94 /// </summary> 95 /// <param name="blogid"> This should be the string MyBlog, which indicates that the post is being created in the user’s blog. </param> 96 /// <param name="username"> The name of the user’s space. </param> 97 /// <param name="password"> The user’s secret word. </param> 98 /// <param name="post"> A struct representing the content to update. </param> 99 /// <param name="publish"> If false, this is a draft post. </param> 100 /// <returns> The postid of the newly-created post. </returns> 101 /// TODO:增加一个最新的帖子 102 [XmlRpcMethod("metaWeblog.newPost")] 103 public string newPost( 104 string blogid, 105 string username, 106 string password, 107 Post content, 108 bool publish) 109 { 110 111 return (string)this.Invoke("newPost", new object[] { blogid, username, password, content, publish }); 112 } 113 114 /// <summary> 115 /// Edits an existing entry on a blog. 116 /// </summary> 117 /// <param name="postid"> The ID of the post to update. </param> 118 /// <param name="username"> The name of the user’s space. </param> 119 /// <param name="password"> The user’s secret word. </param> 120 /// <param name="post"> A struct representing the content to update. </param> 121 /// <param name="publish"> If false, this is a draft post. </param> 122 /// <returns> Always returns true. </returns> 123 /// TODO:更新一个帖子 124 [XmlRpcMethod("metaWeblog.editPost")] 125 public bool editPost( 126 string postid, 127 string username, 128 string password, 129 Post content, 130 bool publish) 131 { 132 133 return (bool)this.Invoke("editPost", new object[] { postid, username, password, content, publish }); 134 } 135 136 /// <summary> 137 /// Deletes a post from the blog. 138 /// </summary> 139 /// <param name="appKey"> This value is ignored. </param> 140 /// <param name="postid"> The ID of the post to update. </param> 141 /// <param name="username"> The name of the user’s space. </param> 142 /// <param name="password"> The user’s secret word. </param> 143 /// <param name="post"> A struct representing the content to update. </param> 144 /// <param name="publish"> This value is ignored. </param> 145 /// <returns> Always returns true. </returns> 146 /// TODO:删除一个帖子 147 [XmlRpcMethod("blogger.deletePost")] 148 public bool deletePost( 149 string appKey, 150 string postid, 151 string username, 152 string password, 153 bool publish) 154 { 155 156 return (bool)this.Invoke("deletePost", new object[] { appKey, postid, username, password, publish }); 157 } 158 159 160 /// <summary> 161 /// Returns information about the user’s space. An empty array is returned if the user does not have a space. 162 /// </summary> 163 /// <param name="appKey"> This value is ignored. </param> 164 /// <param name="postid"> The ID of the post to update. </param> 165 /// <param name="username"> The name of the user’s space. </param> 166 /// <param name="password"></param> 167 /// <returns>
An array of structs that represents each of the user’s blogs. The array
will contain a maximum of one struct, since a user can only have a
single space with a single blog. </returns> 168 /// TODO:得到用户的博客清单 169 [XmlRpcMethod("blogger.getUsersBlogs")] 170 public UserBlog[] getUsersBlogs( 171 string appKey, 172 string username, 173 string password) 174 { 175 176 return (UserBlog[])this.Invoke("getUsersBlogs", new object[] { appKey, username, password }); 177 } 178 179 /// <summary> 180 /// Returns basic user info (name, e-mail, userid, and so on). 181 /// </summary> 182 /// <param name="appKey"> This value is ignored. </param> 183 /// <param name="postid"> The ID of the post to update. </param> 184 /// <param name="username"> The name of the user’s space. </param> 185 /// <param name="password"></param> 186 /// <returns> A struct containing profile information about the user. 187 /// Each struct will contain the following fields: nickname, userid, url, e-mail, 188 /// lastname, and firstname. </returns> 189 /// TODO:得到用户信息 190 [XmlRpcMethod("blogger.getUserInfo")] 191 public UserInfo getUserInfo( 192 string appKey, 193 string username, 194 string password) 195 { 196 197 return (UserInfo)this.Invoke("getUserInfo", new object[] { appKey, username, password }); 198 } 199 200 201 /// <summary> 202 /// Returns a specific entry from a blog. 203 /// </summary> 204 /// <param name="postid"> The ID of the post to update. </param> 205 /// <param name="username"> The name of the user’s space. </param> 206 /// <param name="password"> The user’s secret word. </param> 207 /// <returns> Always returns true. </returns> 208 /// TODO:获取一个帖子 209 [XmlRpcMethod("metaWeblog.getPost")] 210 public Post getPost( 211 string postid, 212 string username, 213 string password) 214 { 215 216 return (Post)this.Invoke("getPost", new object[] { postid, username, password }); 217 } 218 219 /// <summary> 220 /// Returns the list of categories that have been used in the blog. 221 /// </summary> 222 /// <param name="blogid"> This should be the string MyBlog, which indicates that the post is being created in the user’s blog. </param> 223 /// <param name="username"> The name of the user’s space. </param> 224 /// <param name="password"> The user’s secret word. </param> 225 /// <returns>
An array of structs that contains one struct for each category. Each
category struct will contain a description field that contains the name
of the category. </returns> 226 /// TODO:得到博客分类 227 [XmlRpcMethod("metaWeblog.getCategories")] 228 public Category[] getCategories( 229 string blogid, 230 string username, 231 string password) 232 { 233 234 return (Category[])this.Invoke("getCategories", new object[] { blogid, username, password }); 235 } 236 } 237 #endregion 238 } 239
三、图示【调用API发送第一篇简单博客】
——————————————————————————————————————————
资源链接:
http://www.xmlrpc.com/spec 英文的xml-rpc规范
RFC: MetaWeblog API MetaWeblog API 规范
http://www.duduwolf.com/post/41.asp 中文翻译的xml-rpc规范(感谢翻译者:滴水)
http://www.XML-RPC.Net XML-RPC的.NET 实现,其中有最新.net2.0的XML-RPC实现的下载
MetaWeblogAPI and MSN Spaces MSDN上关于MetaWeblog API及MSN Spaces接口的说明及.NET示例