Typecho 0.9接口使用手册
一、简介
1、本接口应用于typecho 日志文章发布
2、本接口支持发布采集来的评论内容评论用户免注册详见发布参数ruser的说明
3、本接口支持发布自定义字段
4、本接口支持自由选择文章状态如草稿或发布
5、本接口支持附件入库
6、 typech o是utf8网站请在发布规则中选择编码为UTF-8
7、本接口基于typecho原版制作应用于其他版本时请自行测试调整
8、接口文件无须任何改动即可使用如果你希望增加校验或其他功能请仔细修改
9、 3个接口文件请复制在admin目录下使用
二、安装接口
在接口文件夹中找到接口文件如图
请将etchk.php、 etpost.php、 etreply.php等接口文件上传到指定目录请使用二进制方式上传如图
三、配置发布规则
1、将范例发布规则文本导入ET2发布配置或使用软件内置发布规则范例如图
2、将检查网址、发布网址和回复网址中的“您的网站”改为您要发布的网站网址如图
3、在参数取值页填上您要发布的网站分类ID分类ID可留空如图
这里查看分类ID
4、填上您的博客账号、密码注意格式这里的账号必须具备发布文章的权限如图
5、您可以用免注册的用户名发布评论内容 ruser参数用于设置这类免注册的用户名如果有多个帐号将随机选用
您可以在附加参数队列中填写它的值也可以在采集规则中建立数据项采集它的值两种方法不能同时使用如果ruser参数为空则使用账号密码队列中的账号发布评论。a、在附加参数队列中的设置示范如下图
b、在采集规则中建立“回复人”数据项采集时的发布规则对应设置示范如下图
6、在附加参数中设置自定义字段名称、类型、取值如图
7、你还可以用采集的方式获取自定义字段的值如图
四、接口说明
一、检查接口
1、接口文件名etchk.php为保密请自行修改文件名
2、本接口文件请复制在网站admin目录中使用如果目录名有变更请自行对应
3、主要参数title
文章标题vercode
安全校验码 自行设定并在检查接口文件开始处修改vercode使其一致
4、发布配置-检查网址处可以如下填写http://您的网址/admin/etchk.php?title=<%title%>&vercode=
注使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
5、接口文件无须任何改动即可使用如果你希望增加校验或其他功能请仔细修改
二、发布接口
1、接口文件名etpost.php为保密请自行修改文件名
2、本接口文件请复制在网站admin目录下使用为保密请自行修改文件名注 以下参数名后“=”号为示范取值而用参数名本身不含“=”号
固定取值的参数可以在发布规则-参数取值中设置
采集取值的参数项请在发布规则-发布项中添加
3、必填参数username
用户名参数名对应的会员名取值填写在发布配置-参数取值-账号密码队列中会员名必须具备发布日志的权限userpassword
密码参数名对应密码取值填写在发布配置-参数取值-账号密码队列中title
主题标题参数名text
内容参数名若要将部分内容作为摘要则在内容中插入typecho的摘要分隔标记<!--more-->
4、主要参数vercode
安全校验码请自行设定并在发布接口文件开始处修改vercode使其一致本项用以防止接口被他人利用如果需要进行更多校验请自行填加相关代码。etattachs
文件列表参数名 附件入库必须使用如图
ruser
作为评论时用的用户名列表随机选用格式为(ruser=帐号一,帐号二,帐号三)每一个“帐号”用英文半角逗号分隔这里的“帐号”不须注册可任意填写可以为空ruser参数为空时随机使用账号密码中填写的用户名do
文章发布状态 publ ish为发布 save为草稿
5、可选参数category[]
分类ID如果属于多个分类格式如图
fieldNames[]
自定义字段名称fieldTypes[]
自定义字段类型字符型为str、数字型为int、小数型为floatfieldValues[]
自定义字段取值
设置一个自定义字段的完整参数设置如图
设置多个自定义字段应注意参数的顺序如图
tags
标签trackback
引用通告多个地址请用换行隔开。al lowComment
是否允许评论 1为允许 0或留空为不允许al lowPing
是否允许被引用 1为允许 0或留空为不允许
al lowFeed
是否允许在聚合中出现 1为允许 0或留空为不允许visibi l ity
公开度取值范围公开为publ ish私密为private密码为password隐藏为hidden待审核为waitingpassword
文章访问密码 当visibi l ity取值为password时生效date
发布日期标准长日期格式不用则留空
6、附件
附件入库需要设置参数etattachs
使用附件入库 ET方案必须选择“先上传文件”
使用附件入库必须上传文件到指定文件夹 即/usr/uploads 目录年月子目录可选。
文件显示URL必须填写为/usr/uploads如图
7、发布配置-发布网址处可以如下填写http://您的网址/-admin/etpost.php
注使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
8、接口文件无须任何改动即可使用如果你希望增加校验或其他功能请仔细修改
三、回复接口
1、接口文件名etreply.php为保密请自行修改文件名
2、本接口文件请复制在网站admin目录下使用
3、本接口文件不能独立使用必须配合发布接口文件etpost.php使用。
4、要使用本回复请确认对应的采集规则-正文数据项“匹配多条正文”选项有效
5、发布配置-回复网址处可以如下填写http://您的网址/admin/etreply.php
注使用大小写敏感的服务器的用户请注意网址大小写和网站文件一致
6、接口文件无须任何改动即可使用如果你希望增加校验或其他功能请仔细修改
五、常见错误
一、 [err]账号密码错误[/err]
1、检查发布规则-参数取值-账号密码队列
二、 [err]inval id vercode[/err]
1、在发布规则-检查网址中填写的vercode值和检查接口文件中的vercode值不一致
2、在发布规则-参数取值-附件参数队列中填写的vercode值和发布接口文件中的vercode值不一致
三、 [err]标题不能为空[/err]
1、使用的采集规则未能正确采集到标题
2、采集规则的数据整理将标题过滤了
3、错误的修改了发布规则-发布项中的标题参数名正确的参数名请看本文接口说明部分
4、发布规则未开启utf-8编码转换
四、 [err] POST fai lure[/err]
1、发布参数设置不当
五、文章乱码
1、发布规则未开启utf-8编码转换
2、数据整理不当
六、附件上传不成功
1、检查附件保存路径和格式是否正确
2、检查附件是否存在
3、检查FTP目录和权限设置
七、 图片不显示
1、检查发布规则文件显示URL设置
2、如果启用FTP上传则文件显示URL和FTP上传目录应一致
3、如果使用保存目录而未使用FTP上传则文件显示URL应和方案的文件保存目录一致
云雀云(larkyun)当前主要运作国内线路的机器,最大提供1Gbps服务器,有云服务器(VDS)、也有独立服务器,对接国内、国外的效果都是相当靠谱的。此外,还有台湾hinet线路的动态云服务器和静态云服务器。当前,larkyun对广州移动二期正在搞优惠促销!官方网站:https://larkyun.top付款方式:支付宝、微信、USDT广移二期开售8折折扣码:56NZVE0YZN (试用于常州联...
licloud官方消息:当前对香港机房的接近100台物理机(香港服务器)进行打折处理,30Mbps带宽,低至不到40美元/月,速度快,性价比高,跑绝大多数项目都是绰绰有余了。该款香港服务器自带启动、关闭、一键重装功能,正常工作日内30~60分钟交货(不包括非工作日)。 官方网站:https://licloud.io 特价香港物理服务器 CPU:e3-1230v2(4核心、8线程、3.3GH...
Sharktech最近洛杉矶和丹佛低价配置大部分都无货了,只有荷兰机房还有少量库存,商家又提供了两款洛杉矶特价独立服务器,价格不错,CPU/内存/硬盘都是高配,1-10Gbps带宽不限流量最低129美元/月起。鲨鱼机房(Sharktech)我们也叫它SK机房,是一家成立于2003年的老牌国外主机商,提供的产品包括独立服务器租用、VPS主机等,自营机房在美国洛杉矶、丹佛、芝加哥和荷兰阿姆斯特丹等,主...