17做网站广州,在线企业建站模板,潍坊市做网站,企业建设网站目的是什么意思Luliang的mail2blog脚本#xff0c;通过基于XML-RPC的BloggerAPI来实现的发布blog的功能。BloggerAPI是一套程序接口#xff0c;用以支持远程操作blog.这个规范现在的版本是1.0#xff0c;是个试验版本和α版本。但是#xff0c;规范的研发人员不再对BloggerAPI进一步地开发…Luliang的mail2blog脚本通过基于XML-RPC的BloggerAPI来实现的发布blog的功能。 BloggerAPI是一套程序接口用以支持远程操作blog.这个规范现在的版本是1.0是个试验版本和α版本。但是规范的研发人员不再对BloggerAPI进一步地开发他们正在制定一套新的、更稳定的API新项目的名称为echo. 虽然如此了解一下这个bloggerAPI还是非常有意义的。一方面有很多语言提供了实现包另一方面很blog工具也提供了相应的包如MT。需要说明的是BloggerAPI提供的功能太有限了只定义了6个方法或函数所以出了一个RFC叫 MetaWeblog API对其进行了扩展。我看了一下MT2.6.4就支持MetaWeblogAPI. 下面对二者进行简单地介绍以后有机会再跟echo比较一下。BloggerAPI based on XML-RPC1、方法列表方法说明blogger.newPost向批定的blog增加新的文章post,通常会在增加后即发布。blogger.editPost编辑一篇文章(post)通常会在修改后发布。blogger.getUsersBlogs返回一个成员的所有文章的信息。blogger.getUserInfo鉴证一个用户并反回其信息如userid,email等blogger.getTemplate返回指定的blog的主要或文档索引模板blogger.setTemplate编辑指定的blog的主要或文档索引模板2、blogger.newPost参数说明参数说明appkey (string)发送这个post的程序的唯一标志blogid (string)这个post即将发送到的blog的标志username (string)有权post文章的用户名password (string)用户密码content (string)Post的内容publish (boolean)是否发布示例请求XML-RPC调用的数据POST /api/RPC2 HTTP/1.0User-Agent: Java.Net Wa-Wa 2.0Host: plant.blogger.comContent-Type: text/xmlContent-length: 515?xml version1.0?methodCallmethodNameblogger.newPost/methodNameparamsparamvaluestringC6CE3FFB3174106584CBB250C0B0519BF4E294/string/value/paramparamvaluestring744145/string/value/paramparamvaluestringewilliams/string/value/paramparamvaluestringsecret/string/value/paramparamvaluestringToday I had a peanut butter and pickle sandwichfor lunch. Do you like peanut-butter and pickle sandwiches? I do. Theyre yummy. Please comment!/string/value/paramparamvaluebooleanfalse/boolean/value/param /params/methodCall成功时的应答HTTP/1.1 200 OKConnection: closeContent-Length: 125Content-Type: text/xmlDate: Mon, 6 Aug 20001 19:55:08 GMTServer: Java.Net Wa-Wa/Linux?xml version1.0?methodResponseparamsparamvaluestring4515151/string/value/param/params/methodResponse失败时的应答错误信息通过XML-RPC methodResponse及fault 项返回包含着的 struct 有错误码和描述,这是由xml-rpc规范定义. HTTP/1.1 200 OKConnection: closeContent-Length: 225Content-Type: text/xmlDate: Mon, 6 Aug 20001 19:55:08 GMTServer: Java.Net Wa-Wa/Linux?xml version1.0?methodResponsefaultvaluestructmembernamefaultCode/namevalueint4/int/value/membermembernamefaultString/namevaluestringjava.lang.Exception: java.lang.Exception: Error: AppKey isinvalid or inactive./string/value/member/struct/value/fault/methodResponse3、blogger.editPost参数说明参数说明appkey (string)发送这个post的程序的唯一标志postid (string)某篇post的唯一标志username (string)有权修改文章的用户名作者或管理员password (string)用户密码content (string)Post的内容publish (boolean)是否发布4、blogger.getUserBlogs参数说明参数说明appkey (string)发送这个post的程序的唯一标志username (string)用户名password (string)用户密码成功应答示例HTTP/1.1 200 OKConnection: closeContent-Length: 125Content-Type: text/xmlDate: Mon, 6 Aug 20001 19:55:08 GMTServer: Java.Net Wa-Wa/Linux?xml version1.0 encodingISO-8859-1?methodResponseparamsparamvaluearraydatavaluestructmembernameurl/namevaluehttp://stuff.foo.com/biz/value/membermembernameblogid/namevalue2997323/value/membermembernameblogName/namevalueBlogger Biz Dev/value/member/struct/valuevaluestructmembernameurl/namevaluehttp://www.blogger.com//value/membermembernameblogid/namevalue2723/value/membermembernameblogName/namevalueBlogger News/value/member/structvaluestructmembernameurl/namevaluehttp://www.geocities.com/rafting//value/membermembernameblogid/namevalue223723/value/membermembernameblogName/namevalueRaftingBlog/value/member/struct/value/value/data/array/value/param/params/methodResponse5、blogger.getUserInfo参数说明参数说明appkey (string)发送这个post的程序的唯一标志username (string)用户名password (string)用户密码成功应答示例 HTTP/1.1 200 OKConnection: closeContent-Length: 125Content-Type: text/xmlDate: Mon, 6 Aug 20001 19:55:08 GMTServer: Java.Net Wa-Wa/Linux?xml version1.0 encodingISO-8859-1?methodResponseparamsparamvaluestructmembernamenickname/namevalueEv./value/membermembernameuserid/namevalue1/value/membermembernameurl/namevaluehttp://www.evhead.com/value/membermembernameemail/namevalueevpyra.com/value/membermembernamelastname/namevalueWilliams/value/membermembernamefirstname/namevalueEvan/value/member/struct/value/param/params/methodResponse6、blogger.getTemplate参数说明参数说明appkey (string)发送这个post的程序的唯一标志blogid (string)这个post即将发送到的blog的标志username (string)有权post文章的用户名password (string)用户密码templateType (string)指定返回哪个模板目前只能是 main 或 archiveIndex.成功时的应答....表示此处内容被我省略。?xml version1.0 encodingISO-8859-1?methodResponseparamsparamvaluelt;HTMLlt;HEADlt;TITLE$BlogTitle$: $BlogDescription$/TITLE lt;/BODYlt;/HTML /value/param/params/methodResponse7、blogger.setTemplate参数说明参数说明appkey (string)发送这个post的程序的唯一标志blogid (string)这个post即将发送到的blog的标志username (string)有权post文章的用户名password (string)用户密码template (string)模板文本通常是HTML.必须包含 和标签因它们需要发布。 我的mainindex里没有啊templateType (string)指定返回哪个模板目前只能是 main 或 archiveIndex.请求格式示例POST /api/RPC2 HTTP/1.0 User-Agent: Java.Net Wa-Wa 2.0 Host: plant.blogger.com Content-Type: text/xml Content-length: 515 ?xml version1.0? methodCall methodNameblogger.setTemplate/methodName params paramvaluestringC6CE3FFB3174106584CBB250C0B0519BF4E294/string/value/param paramvaluestring744154/string/value/param paramvaluestringewilliams/string/value/param paramvaluestringsecret/string/value/param paramvaluestringlt;htmlgt;lt;headgt;lt;titlegt;lt;$BlogTitle$gt;lt;/titlegt;lt;/headgt;lt;bodygt;lt;Bloggergt;lt;BlogDateHeadergt;lt;h1gt;lt;$BlogDateHeaderDate$gt;lt;/h1gt;lt;/BlogDateHeadergt;lt;$BlogItemBody$gt;lt;brgt;lt;/Bloggergt;lt;/bodygt;lt;/htmlgt;/string/value/param paramvaluestringmain/string/value/param /params /methodCall MetaWeblog API这个rfc的最新发布是在08/26/2003.1、什么是MetaWeblog API MetaWeblog API (MWA)是一套编程接口允许外面的程序能取得和设置blog文章的文本或属性。它基于流行的XML-RPC通信协议,后者在很多的流行的开发环境中都有了实现的包。 2、MetaWeblog API与Blogger API 的关系 MetaWeblog API是对Blogger API增强, Blogger API只能取得或设置blog文章的文本内容(hedong问能取得吗).在2002年春天MWA面世,在此以前许多blog工具能存储许多扩展数据但不能访问或编辑这些数据因为没有一个通过的API。 到2003年夏天在本文的写作期间大部分流行的blog工具和编辑器能同时支持Blogger API 和MetaWeblog API.3、MetaWeblog API和 RSS 2.0 的关系 MetaWeblog API利用XML-RPC来描述一篇blog文章. 我们使用了RSS2.0中对一个项的术语来描述一篇blog文章的元数据而不是重新发明一套。请参照RSS2.0中对文章的title, link 、descriptionauthor, comments, enclosure, guid等的定义或命名。 更进一步由于RSS2.0是可扩展的因而MetaWeblog API也是可扩展的. 我们在MWA中设计了一些用以表述属性和命名空间的约定。4、基本函数(entry-points)1)metaWeblog.newPost (blogid, username, password, struct, publish) returns string2)metaWeblog.editPost (postid, username, password, struct, publish) returns true3)metaWeblog.getPost (postid, username, password) returns structblogid, username, password 和publish参数的含义同 Blogger API. newPost返回的字符串表示post_id,同Blogger API定义的一样. 而那个struct就是MWA的精华所在。 5、数据结构 在newPost和editPost中内容信息不再跟BloggerAPI中那是一个字符串而是一个数据结构。这个数据结构的成员就是rss2.0中定义的ITEM的元素。参见后面附表。 当一个元素有属性时用一个数据结构属性做成员传递属性及其相应的值。如enclosure元素用一个包含url, length 和type的结构传递属性。 对source元素数据结构的成员为url 和name前者为source的属性后者为source值。 对categories元素传递一个字符串数组。在服务器端如果传来的category不存在则忽略不报错且只保存有效的那些category.(hedong好象没说domain属性的事啊 服务器必须忽略所有不能理解的元素。 在调用 metaWeblog.newPost 或 metaWeblog.editPost时如果数据结构中含有一个名叫flNotOnHomePage的 boolean 值则主页不显示此文章而只在分类中显示。6、其它函数1metaWeblog.newMediaObject (blogid, username, password, struct) returns struct 参数的struct至少包含name, type and bits三个元素。name是个字符串可以用来作存储对象的文件名或用于对象列表的显示。它决定weblog如何引用这个对象。如果name和weblog已有一个对象重名则替换掉已有的对象。type是个字符串表示对象的类型必须是个标准的MIME类型如 audio/mpeg or image/jpeg or video/quicktime.bits是个base64-编码的二进制值包含着对象的内容。这个结构可以含有其它的元素这些元素可以或不能被内容管理系统保存.当调用失败时抛出error.当成功时返回的strcut中至少要有一个元素url用以指明这个对象如何被访问。其值只能是一个HTTP url或FTP url.2metaWeblog.getCategories (blogid, username, password) returns struct返回的struct中为每个分类提供一个子结构子结构中至少包含三个元素description, httpurl 和 rssurl.3metaWeblog.getRecentPosts (blogid, username, password, numberOfPosts) returns array of structs 返回是一个结构数组盛放着最新发布的文章信息。每个结构的内容同metaWeblog.getPost返回内容相同. numberOfPosts指明要取回的按发布时间倒序计数的文章数量当值超过总文章数时返回全部文章信息。 7、传送带属性的元素 除了enclosure和source元素有专门规定外其它元素按下列规则处理1)如果一个元素有属性则用一个struct来表示各属性为struct的子元素。2)如果一个元素同时有属性和值则用一个一个struct来表示各属性为struct的子元素再增加一个叫_value的子元素表示元素的值。这也就要求元素的属性名不能为_value. 8、传送某命名空间的元素 RSS 2.0允许使用命名空间. 如果你要传送的元素是一个命名空间的一部分那就在传递给 newPost 或 editPost 的struct中增加一个子struct,以指明命名空间的URL为名以要传送的元素值为子元素。 9、说明 在MWA中不要明确要求传送appkey值如果应用程序要传送appkey,则在struct中增加一个名为appkey的元素并赋之以相关的值。 附表RSS2.0中ITEM的元素列表 元素(Element)描述(Description)例子(Example)重要性属性title项(item)的标题Venice Film Festival Tries to Quit Sinking必备link项的URLhttp://www.nytimes.com/2002/09/07/movies/07FEST.html必备description项的大纲Some of the most heated chatter at the Venice Film Festival this week was about the way that the arrival of the stars at the Palazzo del Cinema was being staged.必备author该项作者的emailoprahoxygen.net可选category包含该项的一个或几个分类(catogory)Simpsons Characters可选domain可选指分类法的URLcomments该项的评论(comments)页的URLhttp://www.myblog.org/cgi-local/mt/mt-comments.cgi?entry_id290可选enclosure描述该附带的媒体对象可选url/length/type皆必备,type须是标准MIME类型guid项的唯一标志符串http://inessential.com/2002/09/01.php#a2可选isPermaLink可选默认为真指明guid是否为一永久URL。pubDate项的发布时间Sun, 19 May 2002 15:21:36 GMT可选source该项来自的RSS道Quotes of the Day可选Url必备附MWAAPI清单metaWeblog.newPost (blogid, username, password, struct, publish) returns stringmetaWeblog.editPost (postid, username, password, struct, publish) returns truemetaWeblog.getPost (postid, username, password) returns structmetaWeblog.newMediaObject (blogid, username, password, struct) returns structmetaWeblog.getCategories (blogid, username, password) returns structmetaWeblog.getRecentPosts (blogid, username, password, numberOfPosts) returns array of structs
