MetaWebLog API — 一个多平台文章同步的思路

文章选自个人博客：https://blog.ljyngup.com/archives/578.html/

原由

为了给博客带来流量，我在CSDN，博客园，简书上开通了帐号而且把博客里的一些能够发布的文章也在这些平台发布。

可是同时维护三个博客平台实在太麻烦了，一旦有个地方要修改，三个博客平台所有要修改。因此如今也基本没有同步发布了，可是我始终想实现博客平台同步发布，同步修改。

因而开始研究博客园的发布文章接口，一开始本身抓包分析，发现实在麻烦。因而谷歌之，发现了Metaweblog这个很是好用的API

介绍

XML-RPC是一个远程过程调用（远程过程调用）（remote procedure call，RPC)的分布式计算协议，经过XML将调用函数封装，并使用HTTP协议做为发送机制。

XML-RPC发表于1998年，由UserLand Software（UserLand Software）的Dave Winer及Microsoft共同发表。后来在新的功能不断被引入下，这个标准慢慢演变成为今日的SOAP协议。

可见这个协议发布的很是早，它的官网停留在了2004年。关于这方面的资料很是少，只有在MSDN和博客园很早的文章中才能寻得一点蛛丝马迹。

可咱们讲的是Metaweblog，为何还要介绍XMLPRC？

MetaWeblog API（MWA）是一个编程接口，容许外部程序获取和设置weblog帖子的文本和属性。它创建在流行的XML-RPC通讯协议之上，在许多流行的编程环境中均可以使用实现。

在2003年之际，不少的博客平台开始支持MetaWeblog API，容许第三方编辑器和内容管理器对博客进行编辑管理。

在如今，好比MWeb,Windows Live Writer的文章发布都是以这个API为基础的！

而这个API，就是9102年博客同步的关键所在！

接口介绍

折腾了两天，被博客园的一篇有小错误的文章搞得心态全崩，后来查了MSDN才能够成功请求。

以博客园为例，有这些接口

blogger.deletePost —— 删除文章
blogger.getUsersBlogs —— 获取用户博客信息
metaWeblog.editPost —— 编辑文章
metaWeblog.getCategories —— 获取用户博客分类
metaWeblog.getPost —— 获取文章
metaWeblog.getRecentPosts —— 获取最近的文章
metaWeblog.newMediaObject —— 添加媒体对象（图片等）
metaWeblog.newPost —— 添加文章
wp.newCategory —— 添加目录

咱们主要用到的接口是getUsersBlogs；editPost；getRecentPosts；newPost.

经过newPost循环多平台发布文章，editPost和getRecentPosts做为后续管理和编辑的方法。

而getUsersBlogs可用可不用，在一些平台上要经过此方法获取blogid才能够实现下面方法，可是博客园只要帐号密码就能够实现。

不过这个方法能够获取用户名，对于工具的用户体验有帮助

实现过程

调试工具：精易网页助手
API接口地址：https://rpc.cnblogs.com/metaweblog/博客名
访问方法：POST
编码：UTF-8

1.blogger.getUsersBlogs

参数：
1)[string]xmlrpc_url(即上述API接口地址)
2)[string]username(博客园帐号)
3)[string]pwd(博客园密码)

这一步为获取博主信息，上面说到这步其实能够省略，可是为了下面的工具编写，咱们依旧演示。

可见咱们成功获取了blogid和用户名(非博客名)

2.metaWeblog.newPost

参数：
1)[string]blogid(通过测试，此项被忽略可是不能删去对应标签)
2)[string]username
3)[string]pwd
4)[struct]Post(此项是一个结构，具体参考文末的博客园文档)
5)[bool]publish(是否发布.1为发布,0为不发布)

这里吐槽两句，博客园的一篇文章给了这个方法的示例，可是我请求时老是显示Request from client does not contain valid XML.可是我提交的XML没有错误，直到找到了MSDN上的一个示例，猛地看到encoding。
没错，post提交信息必须以UTF-8编码，以前一直以gb2312提交，永远提示错误。固然，若是不提交中文，编码随意~

演示：

显示的字符串说明发布成功，字符串为该文章的postid

博客页面：

发布成功，URL地址的最后就是刚刚获取到的postid，内容也是刚刚提交的内容。

最重要的一步，也是坑我最久的一步搞定~

3.metaWeblog.getRecentPosts

参数：
1)[string]blogid(ignored)
2)[string]username
3)[string]pwd
4)[int]numberOfPosts(获取文章的数量)

这个是接下来我作工具想要的一个功能，用于查看是否同步到最新文章

演示(解析树很长，截不完整，是对的)：

4.metaWeblog.editPost

用法同newPost只是要加一个postid的参数，这个在getRecentPost中能够获取到~

一点总结

这是一个很是有用的接口，已知国内CTO,博客园,开源中国都支持此方法发布文章。那么就能够写出一个博客同步发表工具，做为独立博客流量的入口，提升了同步效率！

参考文章

此次参考的文章感受都是2000年时代的，本身一点点查文档研究也是不容易了……

• XML-RPC 简单理解与博客园的MetaWeblog协议
• 博客园MetaWeblog文档
• MetaWeblog - 维基百科
• XML - 维基百科
• XMLRPC官网
• metaWeblog.newPost示例 - MSDN