但是官方的接口限制比较多,并且参数必须写成
code腾石建站
- apiAdv_1: `ekey=1&pid=3`, // 广告位标签adv
- apiArclist_1: `ekey=1&channel=2&limit=4`, // 第一个文档列表标签arclist
- apiArclist_2: `ekey=2&typeid=12&limit=3`, // 第二个文档列表标签arclist
看起来参数好乱,并且接口只返回他规定死的字段,所以在官方的基础上改造了一款适合普通小白的一套接口
主要修改之处:
1,列表接口
列表接口主要调整为:获取主表的全部字段,修改flag的OR关系改成AND,去掉对时间的处理,增加*,表示调用全部扩展字段,修改当为空时候返回false改成返回空数组...
另:列表接口增加筛选参数:shaixuan=array();小程序端只需要按照格式:
code腾石建站
- var shaixuan = [
- { 'name': 'size', 'value': '', 'type': 'like'},
- { 'name': 'yanse', 'value': '', 'type': 'like'},
- { 'name': 'jiawei', 'value': '', 'type': 'like'}
- ];
就可以轻松实现小程序端的筛选;
2、详情页接口
返回全部字段、增加阅读量+1,去掉对title的长度限制;把上下页接口合并过来
3、栏目接口调整
返回全部字段,去掉隐藏字段过滤,返回全部字段
4、新增tag接口,新增文章属性接口(主要针对产品属性)
目前优化版接口主要实现的功能:
(1)index接口--批量请求接口
用途:可批量请求多个栏目信息
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=index
参数:
code腾石建站
- var params = [
- { 'name': 'products', 'typeid': 3, 'num': 8, 'more': 0, 'order': 'rand()', 'flag':'c,p'},
- { 'name': 'cases', 'typeid': 4, 'num': 4, 'more': 0, 'order': 'aid desc', 'flag':'p'},
- { 'name': 'news', 'typeid': 2, 'num': 6, 'more': 1, 'order': 'aid desc', 'flag':''},
- { 'name': 'about', 'typeid': 8}//该栏目必须是单页面
- ];
(2)category接口--获取栏目
用途:获取栏目信息,并存入缓存(接口做了主键改变,可通过栏目id调用对应信息)
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=category
参数:
code腾石建站
- format:1,//表示把id变为键值
(3)catinfo接口--获取指定栏目信息
用途:获取栏目信息,和category区别为可以实时读取,防止缓存
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=catinfo
参数:
typeid:栏目id
type:调用类型,默认调用自身self,son表示调用子栏目,all表示调用全部
(4)list接口--获取栏目列表
用途:获取文字栏目列表,无论分页与否,都是list接口
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=list
参数:
typeid:栏目id
flag:推荐类型,例:flag:'c,p',
channel:模型id
num:数量
page:分页
pagesize:分页大小
image:是否只调用图片,和flag:'p'意思一样
order:排序
ids:指定调用某些id内容
keyword:搜索关键词
shaixuan:筛选参数
attr:是否调用属性(真的产品属性)
(5)show接口--文章详情页
用途:获取文字详情,并获取对应tag,并对所有字段的图片和video补全路径,同时返回对应属性
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=show
参数:
aid:文章id
(6)ad接口--广告接口
用途:一般用作小程序幻灯片
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=ad
参数:
pid:广告id
(7)system接口--后台设置信息
用途:返回网站信息,用户自定义变量
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=system
参数:无
(8)tag接口--获取tag信息
用途:可以获取所有tag或者该tag对应的文章
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=tag
参数:
type:taglist获取tag列表
type:arclist获取tag对应文章列表
typeid:栏目id
num:数量
page:分页
pagesize:分页大小
order:排序
(9)gusestbook--留言接口
用途:对应自定义表单
接口URL:domain/index.php?m=api&c=index&_ajax=1&a=guestbook
参数:具体参考demo
DEMO效果图:
文章点评