XML远程过程调用

Wikipedia，自由的百科全书

综述

XOOPS提供XML-RPC接口，它允许与XOOPS进行多种服务和工具的交流。

XOOPS提供除了setTemplate/getTemplate以外的所有Blogger API方法，所有metaWeblog API方法，和源自可用的moveabletype API的一种方法。XOOPS同样有它自己的API，可以用作操作邮件和分类。

在你的XML-RPC调用中使用下列的基本主机信息:

• 主机: www.yourhost.com
• 路径: /xmlrpc.php
• 端口: 80

支持方法列表

以下是XOOPS通常支持的XML-RPC方法：

注意：下面的返回值是成功时返回的值。失败时所有的方法都将返回故障。

blogger.newPost

• 描述：发送一个新的条目。管理员可以随意的直接发布邮件。
• 参数：String appkey, String blogid, String username, String password, String content, Boolean publish。
• 返回值：新邮件的String postid

blogger.editPost

• 描述：编辑一个现有的条目。管理员可以随意的直接发布邮件。
• 参数：String appkey, String postid, String username, String password, String content, Boolean publish
• 返回值：布尔型真值

blogger.deletePost

• 描述：删除一个现有的条目，只有管理员可以操作。
• 参数：String appkey, String postid, String username, String password, Boolean publish
• 返回值：布尔型真值

blogger.getPost

• 描述：重新得到一个指定条目的信息。
• 参数：String appkey, String postid, String username, String password
• 返回值：结构包含String userId, String content, ISO.8601 dateCreated, String posted

blogger.getRecentPosts

• 描述：重新得到最近发送条目的指定编号。
• 参数：String appkey, String blogid, String username, String password, Int numberOfPosts
• 返回值：结构数组包括ISO.8601 dateCreated, String userid, String postid, String content

blogger.getUsersBlogs

• 描述：返回用户可以发送的日志的信息。
• 参数：String appkey, String username, String password
• 返回值：结构数组包括String url, String blogid, String blogName

blogger.getUserInfo

• 描述：返回用户信息。
• 参数： String appkey, String username, String password
• 返回值：结构包括String userid, String firstname, String lastname, String nickname, String email, String url

metaWeblog.newPost

• 描述：发送一个新的条目。管理员可以随意的直接发布邮件。
• 参数：String blogid, String username, String password, Struct content, Boolean publish
• 返回值：新邮件的String postid

metaWeblog.editPost

• 描述：编辑一个现有的条目。管理员可以随意的直接发布邮件。
• 参数：String postid, String username, String password, Struct content, Boolean publish
• 返回值：布尔型真值

metaWeblog.getPost

• 描述：重新得到一个指定条目的信息。
• 参数：String postid, String username, String password
• 返回值：结构包括String userid, ISO.8601 dateCreated, String postid, String description, String title, String link, String permaLink

metaWeblog.getRecentPosts

• 描述：重新得到最近发送条目的指定编号。
• 参数：String blogid, String username, String password, int numberOfPosts
• 返回值:结构数组包括ISO.8601 dateCreated, String userid, String postid, String description, String title, String link, String permalink

metaWeblog.getCategories

• 描述：返回用户可以发送的日志中的分类的信息
• 参数：String blogid, String username, String password
• 返回值：结构数组包括String description, String htmlUrl, String rssUrl

mt.getCategoryList

• 描述：返回用户可以发送的日志中的分类的信息
• 参数：String blogid, String username, String password
• 返回值：结构数组包括String categoryId, String categoryName

xoops.newPost

• 描述：发送一个新的条目。管理员可以随意的直接发布邮件。
• 参数：String blogid, String username, String password, Struct content, Boolean publish
• 返回值：新邮件的String postid

xoops.editPost

• 描述：编辑一个现有的条目。管理员可以随意的直接发布邮件。
• 参数：String postid, String username, String password, Struct content, Boolean publish
• 返回值：布尔型真值

xoops.deletePost

• 描述：删除一个现有的条目，只有管理员可以操作。
• 参数：String appkey, String postid, String username, String password, Boolean publish
• 返回值：布尔型真值

xoops.getPost

• 描述：重新得到一个指定条目的信息。
• 参数：String postid, String username, String password
• 返回值：结构包括String userid, ISO.8601 dateCreated, String postid, String description, String title, String link, String permaLink

xoops.getRecentPosts

• 描述：重新得到最近发送条目的指定编号。
• 参数：String blogid, String username, String password, Int numberOfPosts
• 返回值:结构数组包括ISO.8601 dateCreated, String userid, String postid, String description, String title, String link, String permaLink

xoops.getCategories

• 描述：返回用户可以发送的日志中的分类的信息
• 参数：String blogid, String username, String password
• 返回值：结构数组包括String categoryId, String categoryName, String categoryPid

错误代码

下面是错误代码和信息的列表，当出错时返回的故障响应。

• 101:无效、非法的服务器URI
• 102: 语法分析错误
• 103: 找不到模块
• 104: 用户身份验证失败
• 105: 找不到模块API
• 106: 方法响应错误
• 107: 不支持方法
• 108: 无效、非法的参数
• 109: 遗漏参数
• 110: 选择的日志应用程序不存在
• 111: 拒绝方法的权限

客户端软件

下面是一些推荐的可用与XOOPS交流的XML-RPC顾客软件列表：

• w.bloggar:只在Windows环境下使用，推荐3.0或更高版本
• BloGTK :GNU/Linux环境，1.0版本工作很好