User:DGideas/ideasbotkernel/api
本页面展示了ideasBot Kernel支持的大部分API信息。
用户类
[编辑]注册用户:ideas_reg($username,$password)
[编辑]该函数用于注册用户。其中$username是用户名,$password是密码,均为必填项。
支持的Kernel版本号:0.90及以上
返回值:该函数没有返回值(0.90版本)
登录用户:ideas_login($wiki="",$username="",$password="")
[编辑]该函数用于已注册用户的登录。其中$wiki是登录的维基代码,$username是用户名,$password是密码,均为选填项。
支持的Kernel版本号:0.90及以上
返回值:该函数没有返回值(0.90版本)
查询类
[编辑]获得页面内容:ideas_view($pagename)
[编辑]该函数用于查询指定页面的源代码。其中$pagename是请求的页面名称,为必填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回页面的源代码(0.90版本)
获得页面的最后编者:ideas_get_editor($title)
[编辑]该函数用于查询指定页面的最后编者。其中$title是请求的页面名称,为必填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回页面的最后编者用户名(0.90版本)
获得页面的作者:ideas_get_creator($title)
[编辑]该函数用于查询指定页面的作者。其中$title是请求的页面名称,为必填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回页面的作者用户名(0.90版本)
获得页面的大小:ideas_get_size($title)
[编辑]该函数用于查询指定页面的大小。其中$title是请求的页面名称,为必填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回页面的大小(以字节为单位,纯数字,0.90版本)
获得页面的最后编辑时间:ideas_get_last_edit_time($title)
[编辑]该函数用于查询指定页面的最后编辑时间。其中$title是请求的页面名称,为必填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回页面的最后编辑时间(Wiki格式时间,0.90版本)
注意:该函数返回值不是一个标准的时间格式,如需将其转换为UNIX时间戳等,请使用ideas_deal_timestamp函数。
编辑类
[编辑]编辑页面:ideas_edit($title,$text,$summary="")
[编辑]该函数用于编辑页面。其中$title是要编辑的页面,$text是要编辑的页面内容,这两项是必填项。$summary是编辑摘要,是选填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回xml信息(0.90版本)
编辑页面顶部:ideas_edit_top($title,$text,$summary="")
[编辑]该函数用于编辑页面顶部(第0段)。其中$title是要编辑的页面,$text是要编辑的页面第0段的内容,这两项是必填项。$summary是编辑摘要,是选填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回xml信息(0.90版本)
添加新段落:ideas_edit_new($title,$sectiontitle,$text,$summary="")
[编辑]该函数用于在给定页面最底部添加新段落。其中$title是要编辑的页面,$sectiontitle是要添加的段落名称,$text是要编辑的段落的内容,这三项是必填项。$summary是编辑摘要,是选填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回xml信息(0.90版本)
删除页面:ideas_delete($title,$reason="")
[编辑]该函数用于删除给定页面。其中$title是要删除的页面,是必填项。$reason是操作原因,是选填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回xml信息(0.90版本)
注意:删除页面可能需要管理员权限。
移动页面:ideas_move($title,$titletarget,$reason="")
[编辑]该函数用于移动给定页面。其中$title是要移动的原始页面,$titletarget是要移动的目标页面,必须为空。这两项是必填项。$reason是操作原因,是选填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回xml信息(0.90版本)
注意:移动页面可能需要管理员权限。
不保留重定向地移动页面:ideas_move_noredirect($title,$titletarget,$reason="")
[编辑]该函数用于移动给定页面并不在原始页面设置重定向。其中$title是要移动的原始页面,$titletarget是要移动的目标页面,必须为空。这两项是必填项。$reason是操作原因,是选填项。
支持的Kernel版本号:0.90及以上
返回值:该函数返回xml信息(0.90版本)
注意:移动页面可能需要管理员权限。