编辑“Xoops XML远程过程调用”

__NOTOC__
<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[Xoops模块开发指南|上一页]] | {{Template:Xoops导航}}</span>
<div style="clear:both;"></div>

===综述===
[[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版本工作很好 








[[category:Xoops模块开发指南]]