前端接口

数据接口

预留ajax数据接口，方便瀑布流加载，该接口较为简易，支持参数有限，需要丰富参数的接口最好自定义扩展。

接口 index.php/ajax/data.html
请求方式 GET、POST
Content-Type form-data
参数

参数名	示例值	是否必填	参数类型	参数描述
mid	1	必填	text	模型mid 1影片、2文章、3专题、8明星、9角色、11剧情
limit	20	必填	text	每页条数，支持10,20,30
page	1	必填	text	页码，最多不超过20页，防止非法采集
tid	1	必填	text	分类id

-成功响应示例

{
	"code": 1,
	"msg": "数据列表",
	"page": 1,
	"pagecount": 221,
	"limit": 10,
	"total": 2204,
	"list": [
		{
			"vod_id": 3683,
			"type_id": 1,
			"type_id_1": 0,
			"group_id": 0,
			"vod_name": "不表演才艺居然不给我饭吃#抖音汽车",
			...
		},
		{
			"vod_id": 3685,
			"type_id": 1,
			"type_id_1": 0,
			"group_id": 0,
			"vod_name": "所以非要这样吗？#当别人问我上班..",
			...
		},
	]
}

json

搜素联想

接口 /index.php/ajax/suggest
请求方式 GET、POST
参数

参数名	示例值	是否必填	参数类型	参数描述
mid	1	必填	text	模型mid 1影片、2文章、3专题、8明星、9角色、11剧情
wd	招魂	必填	text	关键词
limit	10	必填	text	获取数量
imestamp	1574339368127	必填	text	时间戳

返回数据

{
	"code": 1,
	"msg": "数据列表",
	"page": 1,
	"pagecount": 3,
	"limit": 10,
	"total": 25,
	"list": [
		{
			"id": 1593,
			"name": "我也搞不懂他是怎么被困这里的 #宅家dou剧场  #我的观影报告  #萤火计划",
			"en": "woyegaobudongtashizenmebeikunzhelidezhaijiadoujuchangwodeguanyingbaogaoyinghuojihua",
			"pic": "https://p3.douyinpic.com/tos-cn-p-0015/34f94d7f8bda45048c14988492ef9500_1620207826~tplv-dy-360p.jpeg?from=4257465056&s=&se=false&sh=&sc=&l=202105312051560101501660281A0EC310&biz_tag=feed_cover"
		},
		{
			"id": 1467,
			"name": "假如爱情来临我的心永远不会迟到@DOU+小助手",
			"en": "jiaruaiqinglailinwodexinyongyuanbuhuichidaoDOUxiaozhushou",
			"pic": "https://p3.douyinpic.com/tos-cn-p-0015/be736dd849f744e7848473210c3c8131_1619099706~tplv-dy-360p.jpeg?from=4257465056"
		},
		{
			"id": 1360,
			"name": "有人说我的视频没营养 怎么？你的视频在炖骨头汤？",
			"en": "yourenshuowodeshipinmeiyingyangzenmenideshipinzaidungutoutang",
			"pic": "https://p9.douyinpic.com/tos-cn-p-0015/2af445900fa14c64b03c0d0390e2bd81_1618493679~tplv-dy-360p.jpeg?from=4257465056&s=&se=false&sh=&sc=&l=20210531205248010150201080310EC297&biz_tag=feed_cover"
		},
		{
			"id": 1350,
			"name": "有了油菜花，就承托不出我的马甲线了，",
			"en": "youliaoyoucaihuajiuchengtuobuchuwodemajiaxianliao",
			"pic": "https://p26.douyinpic.com/tos-cn-p-0015/47c6c91025a64b6daa95ee55d33fdcff_1618363339~tplv-dy-360p.jpeg?from=4257465056"
		},
		{
			"id": 1301,
			"name": "#抖in美好溧阳 #万物皆可智慧 #没事开心一下 #摆好你的姿态 #没错是我的腿呀 #你的女友已上线请查收",
			"en": "douinmeihaoliyangwanwujiekezhihuimeishikaixinyixiabaihaonidezitaimeicuoshiwodetuiyanidenvyouyishangxianqingchashou",
			"pic": "https://p29.douyinpic.com/tos-cn-p-0015/6b3f2a301a2b40fd805ed8e1c5b57de6_1618228574~tplv-dy-360p.jpeg?from=4257465056"
		},
		{
			"id": 1284,
			"name": "好久没有直播有没有想我的？@抖音小助手 #舞蹈 #创作灵感",
			"en": "haojiumeiyouzhiboyoumeiyouxiangwodedouyinxiaozhushouwudaochuangzuolinggan",
			"pic": "https://p6.douyinpic.com/tos-cn-p-0015/124267af2a314b54bed771e528cac1a8_1618113455~tplv-dy-360p.jpeg?from=4257465056&s=&se=false&sh=&sc=&l=202105312053370101501821001E0ED364&biz_tag=feed_cover"
		},
		{
			"id": 1246,
			"name": "关于我的故事还是听我的版本好一点#原相机",
			"en": "guanyuwodegushihuanshitingwodebanbenhaoyidianyuanxiangji",
			"pic": "https://p9.douyinpic.com/tos-cn-p-0015/dfa28fcbe6e840f094f824827ff8b7a0_1617918242~tplv-dy-360p.jpeg?from=4257465056&s=&se=false&sh=&sc=&l=20210531205331010150157232090F227B&biz_tag=feed_cover"
		},
		{
			"id": 1199,
			"name": "#创作灵感 #牛仔裤 小时候偷喝我爸两罐红牛，追着我打，笑死，我的能量超乎你想象",
			"en": "chuangzuolingganniuzikuxiaoshihoutouhewobaliangguanhongniuzhuizhuowodaxiaosiwodenengliangchaohunixiangxiang",
			"pic": "https://p26.douyinpic.com/tos-cn-p-0015/488f094a79154123ad43f3152ef3fdd7_1617541987~tplv-dy-360p.jpeg?from=4257465056&s=&se=false&sh=&sc=&l=202105312054250101502221495B0F3590&biz_tag=feed_cover"
		},
		{
			"id": 1189,
			"name": "你有你的背景，我有我的背影，安排#大长腿",
			"en": "niyounidebeijingwoyouwodebeiyinganpaidachangtui",
			"pic": "https://p26.douyinpic.com/tos-cn-p-0015/6f993bd8cd46412c82d41df0f3a64e31_1616750332~tplv-dy-360p.jpeg?from=4257465056"
		},
		{
			"id": 1161,
			"name": "我的小蛮腰中午可以露出来了，继续减肥再瘦十斤#微胖",
			"en": "wodexiaomanyaozhongwukeyiluchulailiaojixujianfeizaishoushijinweipang",
			"pic": "https://p6.douyinpic.com/tos-cn-p-0015/71ccc83db7674648a83d08314a2323de_1617954719~tplv-dy-360p.jpeg?from=4257465056&s=&se=false&sh=&sc=&l=202105312054120101511722311C0F10D3&biz_tag=feed_cover"
		}
	],
	"url": "/index.php/vodsearch/mac_wd-------------.html"
}

json

顶踩接口

接口 /index.php/ajax/digg.html
请求方式 GET、POST
参数

参数名	示例值	是否必填	参数类型	参数描述
mid	1	必填	text	模型mid 1影片、2文章、3专题、8明星、9角色、11剧情
id	1542	必填	text	评论的数据id 影片id 、文章id等
type	up	必填	text	类型，up顶、down踩

返回数据

{
	"code": 1,
	"msg": "操作成功！",
	"data": {
		"up": 826,
		"down": 511
	}
}

json

记录接口

请求方式 GET、POST
接口 /index.php/user/ajax_ulog

参数	示例值	是否必填	参数描述
mid	1	必填	模型mid 1影片、2文章、3专题、8明星、9角色、11剧情
id	1233	必填	评论的数据id 影片id 、文章id等
type	2	必填	浏览1、收藏2, 想看3、播放4、下载5
ac	set	必填	参数为 set 是提交，不为 set 是获取

返回数据

{"code":1,"msg":"保存成功!"}

json

点击量提交

请求方式 GET、POST
请求方式 GET、POST
Content-Type form-data
参数

参数	示例值	是否必填	参数描述
mid	1	必填	模型mid 1影片、2文章、3专题、8明星、9角色、11剧情
id	1233	必填	评论的数据id 影片id 、文章id等
type	update	必填	更新

成功响应示例

{
	"code": 1,
	"msg": "操作成功！",
	"data": {
		"hits": 425,
		"hits_day": 2,
		"hits_week": 2,
		"hits_month": 2
	}
}

json

来路统计

接口 /index.php/ajax/referer
请求方式 GET、POST
参数

参数	示例值	是否必填	参数描述
domain	www.apivv.cn	必填	来路域名，可用 `js` 的 `document.referrer` 来提取
url	https://www.apivv.cn/index.html	必填	来路url，直接提交 `document.referrer`
type	update	必填	更新

模板中只要引入了 \static\js\home.js 那就是只需在公用底部放一个 class 为 mac_referer 的div就可以了。

<div class="mac_referer"></div>

html

响应结果示例

请求方式 GET

{
	"code": 1,
	"msg": "ok",
	"data": {
		"referer": 1,
		"referer_day": 1,
		"referer_week": 1,
		"referer_month": 1
	}
}

json

评论接口

获取评论

接口 /index.php/comment/ajax.html
请求方式 GET

参数	示例值	是否必填	参数描述
rid	1245	必填	数据id
mid	1	必填	模型mid 1影片、2文章、3专题、8明星、9角色、11剧情
page	1	必填	页码

获取评论的数据模板为 /html/comment/ajax.html,网页端获取评论列表会从这里提取数据返回html数据给接口,当然苹果CMS默认已经给我们做好了这些。只需引入 \static\js\home.js 然后在需要展示评论的位置加入以下代码：

<div class="ui-title">
   <h3>评论</h3>
</div>
<div class="mac_comment" data-id="{$obj.vod_id}" data-mid="{$maccms.mid}" ></div>
<script>
   $(function(){
      MAC.Comment.Login = {$comment.login};
      MAC.Comment.Verify = {$comment.verify};
      MAC.Comment.Init();
      MAC.Comment.Show(1);
   });
</script>

html

请求响应结果示例

"    <!--评论开始-->\n    <form class=\"comment_form cmt_form clearfix\"  >\n        <input type=\"hidden\" name=\"comment_pid\" value=\"0\">\n        <!--评论框-->\n        <div class=\"input_wrap fl clearfix\">\n            <textarea class=\"comment_content fl\" name=\"comment_content\" placeholder=\"有事没事说两句...\"><\/textarea>\n            <div class=\"fl clearfix handle\">\n                <div class=\"comment_face_panel face\">\n                    <i class=\"icon-face\"><\/i>\n                <\/div>\n                <div class=\"comment_face_box face-box\">\n                                        <img data-id=\"1\" src=\"\/static\/images\/face\/1.gif\">\n                                        <img data-id=\"2\" src=\"\/static\/images\/face\/2.gif\">\n                                        <img data-id=\"3\" src=\"\/static\/images\/face\/3.gif\">\n                                        <img data-id=\"4\" src=\"\/static\/images\/face\/4.gif\">\n                                        <img data-id=\"5\" src=\"\/static\/images\/face\/5.gif\">\n                                        <img data-id=\"6\" src=\"\/static\/images\/face\/6.gif\">\n                                        <img data-id=\"7\" src=\"\/static\/images\/face\/7.gif\">\n                                        <img data-id=\"8\" src=\"\/static\/images\/face\/8.gif\">\n                                        <img data-id=\"9\" src=\"\/static\/images\/face\/9.gif\">\n                                        <img data-id=\"10\" src=\"\/static\/images\/face\/10.gif\">\n                                        <img data-id=\"11\" src=\"\/static\/images\/face\/11.gif\">\n                                        <img data-id=\"12\" src=\"\/static\/images\/face\/12.gif\">\n                                        <img data-id=\"13\" src=\"\/static\/images\/face\/13.gif\">\n                                        <img data-id=\"14\" src=\"\/static\/images\/face\/14.gif\">\n                                        <img data-id=\"15\" src=\"\/static\/images\/face\/15.gif\">\n                                        <img data-id=\"16\" src=\"\/static\/images\/face\/16.gif\">\n                                    <\/div>\n                <div class=\"remaining-w\">还可以输入<span class=\"comment_remaining remaining fr\" >200<\/span><\/div>\n                <div class=\"smt fr clearfix\">\n                        <span style=\"display: none;\">\n                            <span><\/span>\n                        <\/span>\n                                        验证码:<input class=\"mac_verify cmt_text\" type=\"text\" id=\"verify\" name=\"verify\" \/>\n                                        <input class=\"comment_submit cmt_post\" type=\"button\" value=\"发布\">\n                <\/div>\n            <\/div>\n        <\/div>\n\n    <\/form>\n        <div class=\"cmt_wrap\" >\n            <p class=\"smt_wrap fl clearfix\">\n                <span class=\"total fl\">共<em id=\"item_count\">0<\/em>条评论<\/span>\n            <\/p>\n            \n        <\/div>\n    <!--评论结束-->\n    <div class=\"mac_pages\" >\n        <div class=\"page_tip\">共0条数据,当前\/页<\/div>\n        <div class=\"page_info\">\n            <a class=\"page_link\" href=\"javascript:void(0);\" onclick=\"MAC.Comment.Show(1)\" title=\"首页\">首页<\/a>\n            <a class=\"page_link\" href=\"javascript:void(0);\" onclick=\"MAC.Comment.Show('')\" title=\"上一页\">上一页<\/a>\n                        <a class=\"page_link\" href=\"javascript:void(0)\" onclick=\"MAC.Comment.Show('')\" title=\"下一页\">下一页<\/a>\n            <a class=\"page_link\" href=\"javascript:void(0)\" onclick=\"MAC.Comment.Show('')\" title=\"尾页\">尾页<\/a>\n\n            <input class=\"page_input\" type=\"text\" placeholder=\"页码\" id=\"page\" autocomplete=\"off\" style=\"width:40px">\n            <button class=\"page_btn\" type=\"button\"  onclick="MAC.Comment.Show($('#page').val())">GO<\/button>\n        <\/div>\n    <\/div>\n"

json

提交评论

接口 m/index.php/comment/saveData
请求方式 POST

请求参数

参数	示例值	是否必填	参数描述
comment_mid	1	必填	模型mid 1影片、2文章、3专题、8明星、9角色、11剧情
comment_content	我留了个评论	必填	评论内容
comment_pid	0	选填	回复评id，回复的时候用到
verify	9223	选填	评论验证码，后台如果开启就要提交验证码
comment_rid	1560	必填	评论的数据文章id、影片id

成功响应结果

{"code":1,"msg":"感谢你的留言！"}

json

留言本接口

接口地址 /index.php/gbook/saveData
请求方式 POST

请求参数

参数	示例值	是否必填	参数描述
gbook_content	我留了个言	必填	留言内容
verify	9223	选填	评论验证码，后台如果开启就要提交验证码

成功返回示例

{code: 1, msg: "感谢你的留言！"}

json

定时任务

此接口用来模拟定时执行任务，因为php端脚本不可能弄个 24 小时的计时器，所以必须又前端来触发，也就是用户访问时判断当前时间戳触发。

接口地址 /api.php/timming/index
请求方式 GET

参数	示例值	是否必填	参数描述
t	1545	必填	随机值、时间戳都可以如：`Math.random()`

访问页面触发定时任务，建议放到首页底部；由于入口文件名可变，默认是api.php，如需修改请自定义data-file="xxx.php"

<span style="display: none;" class="mac_timming" data-file="" ></span>

html

后台事件

苹果CMS开放了几个立即执行后台事件执行接口。当然是执行安全范围内并且已配置好的事件。例如：生成html 、采集资源站、采集自定义规则、清空缓存、网址推送等等.

生成html

接口 api.php/timming/make/param/
请求方式 GET

url参数大全

生成首页 /api.php/timming/make/param/ac/index
生成wap首页 /api.php/timming/make/param/ac/index/ac2/wap
生成生成地图 /api.php/timming/make/param/ac/map

视频生成

全部分类 /api.php/timming/make/param/ac=type&tab=vod&vodtype=1,2,3,4,6,7,8,9,10,11,12,13,14,15,16,27
当天分类 /api.php/timming/make/param/ac=type&tab=vod&vodtype=&ac2=day
全部内容 /api.php/timming/make/param/ac=info&tab=vod&vodtype=1,2,3,4,6,7,8,9,10,11,12,13,14,15,16,27
当天内容 /api.php/timming/make/param/ac=info&tab=vod&vodtype=&ac2=day
未生成的 /api.php/timming/make/param/ac=info&tab=vod&ac2=nomake
一键当天 /api.php/timming/make/param/ac=info&tab=vod&vodtype=&ac2=day&jump=1

文章生成

全部分类 /api.php/timming/make/param/ac=type&tab=art&arttype=5,17,18
当天分类 /api.php/timming/make/param/ac=type&tab=art&arttype=&ac2=day
全部内容 /api.php/timming/make/param/ac=info&tab=art&arttype=5,17,18
当天内容 /api.php/timming/make/param/ac=info&tab=art&arttype=&ac2=day
未生成的 /api.php/timming/make/param/ac=info&tab=art&ac2=nomake
一键当天 /api.php/timming/make/param/ac=info&tab=art&arttype=&ac2=day&jump=1

生成专题

选择专题 /api.php/timming/make/param/ac=topic_info
全部专题 /api.php/timming/make/param/ac=topic_info&topic=7,6,5,4,3,2,1
专题首页 /api.php/timming/make/param/ac=topic_index

生成自定义页面：
自定义页面 /api.php/timming/make/param/ac=label&label=aaa$$$top.html


RSS订阅文件  /api.php/timming/make/param/ac=rss&ac2=index
谷歌SiteMap  /api.php/timming/make/param/ac=rss&ac2=google
百度SiteMap  /api.php/timming/make/param/ac=rss&ac2=baidu
SO-SiteMap  /api.php/timming/make/param/ac=rss&ac2=so
搜狗SiteMap  /api.php/timming/make/param/ac=rss&ac2=sogou
Bing-SiteMap  /api.php/timming/make/param/ac=rss&ac2=bing
神马SiteMap  /api.php/timming/make/param/ac=rss&ac2=sm

采集资源站

接口 api.php/timming/collect/param/
请求方式 GET

采集当天 /api.php/timming/collect/param/ac=cj&cjflag=0f8170804201c8383ff33bd788d1a2f8&cjurl=http%3A%2F%2Fcj.wlzy.tv%2Finc%2Fapi_mac_m3u8.php&h=24&t=&ids=&wd=&type=1&mid=1&opt=0&filter=0&filter_from=&param=  

采集本周 /api.php/timming/collect/param/ac=cj&cjflag=0f8170804201c8383ff33bd788d1a2f8&cjurl=http%3A%2F%2Fcj.wlzy.tv%2Finc%2Fapi_mac_m3u8.php&h=168&t=&ids=&wd=&type=1&mid=1&opt=0&filter=0&filter_from=&param=  

采集所有 /api.php/timming/collect/param/ac=cj&cjflag=0f8170804201c8383ff33bd788d1a2f8&cjurl=http%3A%2F%2Fcj.wlzy.tv%2Finc%2Fapi_mac_m3u8.php&h=&t=&ids=&wd=&type=1&mid=1&opt=0&filter=0&filter_from=&param=

清空缓存

接口 api.php/timming/cache/param/
请求方式 GET

参数	示例值	是否必填	参数描述
ac	任意	必填	任意值，建议使用时间戳

/api.php/timming/make/cache/ac=121

网址推送

请求方式 GET
接口 api.php/timming/urlsend/param/

百度主动推送当天视频 /api.php/timming/urlsend/param/ac=Baidu&limit=50&page=1&ac2=today&mid=1
百度主动推送当天文章 /api.php/timming/urlsend/param/ac=Baidu&limit=50&page=1&ac2=today&mid=2
百度主动推送当天专题 /api.php/timming/urlsend/param/ac=Baidu&limit=50&page=1&ac2=today&mid=3
百度主动推送当天演员 /api.php/timming/urlsend/param/ac=Baidu&limit=50&page=1&ac2=today&mid=8
百度主动推送当天角色 /api.php/timming/urlsend/param/ac=Baidu&limit=50&page=1&ac2=today&mid=9
百度快速推送当天视频 /api.php/timming/urlsend/param/ac=Baidufast&limit=10&page=1&ac2=today&mid=1
百度快速推送当天文章 /api.php/timming/urlsend/param/ac=Baidufast&limit=10&page=1&ac2=today&mid=2
百度快速推送当天专题 /api.php/timming/urlsend/param/ac=Baidufast&limit=10&page=1&ac2=today&mid=3
百度快速推送当天演员 /api.php/timming/urlsend/param/ac=Baidufast&limit=10&page=1&ac2=today&mid=8
百度快速推送当天角色 /api.php/timming/urlsend/param/ac=Baidufast&limit=10&page=1&ac2=today&mid=9

生成二维码

官方api，用于当前url生成二维码，便于用户分享网址！

接口地址 //api.maccms.la/qrcode/index/w/150/h/150/url/ 苹果CMS生成二维码使用方法已经在 home.js 集成了，

使用示例

<img class="mac_qrcode" alt="扫一扫手机看"/>

html

生成短网址

官方api，用于url生成短网址，便于用户分享网址！

//api.maccms.la/shorten/index/url/ 使用方法已经在 home.js 集成了，

使用示例

<div class="mac_shorten"></div>
<script>
   MAC.Shorten.Init();
</script>

html

用户接口

用户接口大部分都需要在用户登录状态下才能正常使用，用于常见的信息提交！

用户登录接口

当前登录接口为cms 默认的网页登录接口，app端不支持图像验证码提交，请务必关闭登录验证码！该接口返回的 header 信息可以用来当做 cookie 存储，可用于需要提交cookie 的接口

接口 /index.php/user/login
请求方式 POST
Content-Type form-data
参数

参数	示例值	是否必填	参数描述
user_name	ceshi123	必填	注册用户名
user_pwd	admin123	必填	注册登录密码
user_pwd2	admin123	必填	确认密码
ac	phone	选填	注册验证类型，手机验证phone 、邮箱验证email
code	验证码	选填	手机或者邮箱的验证密码
verify	验证码	选填	后台开启注册验证码时必填

成功响应示例

{
	"code": 1,
	"msg": "注册成功"
}

json

信息发送接口

接口 /index.php/user/reg_msg
参数

参数	示例值	是否必填	参数描述
ac	phone	选填	注册验证类型，手机验证phone 、邮箱验证email
to	[email protected]	选填	手机或者邮箱

成功响应示例

{
	"code": 1,
	"msg": "信息已发送"
}

json

修改资料接口

用于用户修改个人信息，如修改密码、修改昵称、绑定信息，需要用户登录状态的cookie

接口 /index.php/user/info
请求方式 POST
Content-Type form-data
参数

参数	示例值	是否必填	参数描述
user_nick_name	大图模板	选填	修改昵称
user_pwd	admin888	必填	原始密码
user_pwd1	admin888	选填	新密码，不修改密码的话就留空
user_pwd2	admin888	选填	确定密码，不修改密码的话就留空
user_qq	834023388	选填	用户QQ
user_email	[email protected]	选填	用户绑定邮箱，绑定时需要验证邮箱可用信息发送接口
user_phone	[email protected]	选填	用户绑手机号，绑定时需要短信验证

上传头像接口

支持bs64 和文件类型，需要用户登录状态的cookie

接口 /index.php/user/portrait
请求方式 POST
Content-Type form-data
参数

参数	示例值	是否必填	参数描述
file	图片文件	必填	合法图片文件 type="file"
imgdata	base64	必填	合法图片类base64编码

成功响应示例

{
	"code": 1,
	"msg": "头像上传成功",
   "file":"upload/user/4/4.jpg"
}

json