一、简介
制作ET接口需要掌握用户所使用网站的WEB设计语言,如Discuz论坛和Phpwind论坛使用的是PHP语言,Dvbbs论坛使用的是ASP语言,对于熟悉这些WEB开发语言的用户来说,制作ET接口是很简单的事情。
接口制作,一种方法是自己全新编写代码,这需要用户对开发语言掌握比较好;
另一种方法是利用原网站的发布文件、搜索文件等修改为接口文件,例如将GET和cookies的数据都改为从POST接收,去掉或增加登陆验证、权限验证的代码等,这种方法比较快速简单,但需要用户能熟练阅读源文件;
二、注意事项
接口文件相当简单,大家完全可以自己编写,尤其是网站是自己设计开发的朋友。
接口文件有3个,当然,您完全可以使用同一个文件以不同参数来执行不同操作。
接口文件的名称可以随意修改,您只需要在发布配置中填上您的接口文件URL即可。
1、文章检查接口(ETchk)
注:此接口可选用;
功能描述:
用于检查您所发布的网站是否已有同名文章。
参数传递:
ET用POST方法向本接口提交信息。
必要参数1个
参数1:标题
标题参数名可自定,例如我们提供的DZ5.5接口的标题参数名为subject,PW5.3的标题参数名为keyword。
返回值:
如果有同名文章,则返回字符串“1”或“[yes]”,否则返回字符串“0”或“[no]”;
2、文章发布(ETpost)
功能描述:
用于将您所采集的文章发布到您的网站或论坛。
参数传递:
ET用POST方法向本接口提交信息。
参数说明:
ET发布配置-发布项中设置的所有参数都将向此接口发送;
必要参数2个
参数1:标题
标题参数名可自定,例如我们提供的Discuz5.5接口的正文参数名为subject,Phpwind5.3的正文参数名为atc_title。
参数2:正文
正文参数名可自定,例如我们提供的Discuz5.5接口的正文参数名为message,Phpwind5.3的正文参数名为atc_content。
可选参数
(如果您的接口里不需要验证帐号,则发布配置中用户名和密码参数可以任意填写)
参数1:用户名
用户名参数名可自定,例如我们提供的Discuz5.5接口的用户名参数名为auth,Phpwind5.3的用户名参数名为pwuser。
参数2:密码
密码参数名可自定,例如我们提供的Discuz5.5接口的密码参数名为password,Phpwind5.3的密码参数名为pwpwd。
专用参数
(某些预提供的网站发布所需参数,如Discuz、Phpwind)
Discuz:
action=newthread (执行的动作,这里表示发新帖)
topicsubmit=yes (发新帖的必须参数)
typeid=XX (主题分类编号,可不填)
Phpwind:
action=new (执行的动作,这里表示发新帖)
fid=XX (您要发布的论坛版块号)
p_type=XX (主题分类编号,可不填)
返回值:
成功则返回字符串“1”或“[ok]”或[发布成功特征码]([发布成功特征码]见帮助手册-发布配置-模拟发布-成功特征码);
失败则返回字符串“0”或其他自定义信息;
当在ET发布配置中启用独立回复时,发布成功返回值格式为字符串 “[reply]文章主题ID参数名=文章ID;其他参数名1=参数值1;其他参数名2=参数值2[/reply]” ;如果此时不需要回复,则返回字符串“[ok]”。
3、文章回复(ETreply)
注:此接口可选用;用于接收ET向网站提交的数据,并将其作为文章的回复部分或类似形式发布;
当在ET发布配置中启用文章回复接口时,采集配置中的[正文]数据项第一条匹配值将被提交至[发布接口]作为主题发布,其他匹配值将依次被提交至[回复接口]作为该主题的回复部分;
从2.4版开始,支持独立数据项采集回复内容,但发送回复时的回复内容参数名,仍使用正文参数名。
功能描述:
发布如论坛帖子一类文章的回帖。
参数传递:
ET用POST方法向本接口提交信息。
参数说明
ET发布配置-发布项中设置的所有参数以及文章发布(ETpost)接口成功返回字符串“[reply]XXX[/reply]”中包含的参数都将向此接口发送;
参数1:正文
正文参数名在此接口中即为回帖内容的参数名;
参数2:文章主题ID
用于表述回帖对应的主题ID,此参数由文章发布(ETpost)接口返回给ET,并由ET再将它及其值发送给文章回复(ETreply)接口;
参数3:回复序号replyno
内部参数,用于表示当前回复的顺序号,[replyno]取值从1开始,表示当前是第几次回复,用户可通过该参数为接口设计更逼真的回复时间或实现其他功能,该参数由ET自动生成发送给文章回复(ETreply)接口;
其他参数:
除了ET发布配置-发布项中设置的参数外,如果您在此接口中还需要更多参数,请通过文章发布(ETpost)接口的成功返回字符串“[reply]XXX[/reply]”传递。
返回值:
成功则返回字符串“1”或“[ok]”或[发布成功特征码]([发布成功特征码]见帮助手册-发布配置-模拟发布-成功特征码);
失败则返回字符串“0”或其他自定义信息;
注:以上接口文件皆使用POST方式获取参数;
欢迎大家在论坛发布您自己编写的一些通用网站程序的接口文件,分享给其他朋友。