苹果CMS开发

苹果CMS前端接口介绍

2025-03-06 共人阅读

数据接口

预留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": "所以非要这样吗？#当别人问我上班..",
			...
		},
	]
}

搜素联想

接口 /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"
}

顶踩接口

接口 /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
	}
}

记录接口

请求方式 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":"保存成功!"}

点击量提交

请求方式 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
	}
}

来路统计

接口 /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	必填	更新

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

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

响应结果示例

请求方式 GET

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

评论接口

获取评论

接口 /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默认已经给我们做好了这些。只需引入 staticjshome.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>

请求响应结果示例

"    <!--评论开始-->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>nn    </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(&#x27;&#x27;)&; title=&;上一页&;>上一页</a>n                        <a class=&;page_link&; href=&;javascript:void(0)&; onclick=&;MAC.Comment.Show(&#x27;&#x27;)&; title=&;下一页&;>下一页</a>n            <a class=&;page_link&; href=&;javascript:void(0)&; onclick=&;MAC.Comment.Show(&#x27;&#x27;)&; title=&;尾页&;>尾页</a>nn            <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($(&#x27;#page&#x27;).val())">GO</button>n        </div>n    </div>n"

提交评论

接口 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":"感谢你的留言！"}

留言本接口

接口地址 /index.php/gbook/saveData

请求方式 POST

请求参数

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

成功返回示例

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

定时任务

此接口用来模拟定时执行任务，因为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>

后台事件

苹果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="扫一扫手机看"/>

生成短网址

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

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

使用示例

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

用户接口

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

用户登录接口

当前登录接口为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": "注册成功"
}

信息发送接口

接口 /index.php/user/reg_msg

参数

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

成功响应示例

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

修改资料接口

用于用户修改个人信息，如修改密码、修改昵称、绑定信息，需要用户登录状态的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]	选填	用户绑定邮箱，绑定时需要验证邮箱可用[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"
}

标签：接口