苹果CMS内置AJAX数据接口完整调用教程

AJAX数据接口基础说明

苹果CMS自带通用AJAX数据请求接口，无需自行开发后端查询逻辑，仅通过传参即可异步获取视频、文章、专题三类模块数据，常用于首页下拉加载、侧边异步推荐、弹窗内容加载等前端交互场景。

接口请求可用参数详解

• mid：区分内容模块，1=视频模块，2=文章模块，3=专题模块，该参数为必传项

• limit：单页返回数据条数，仅支持10、20、30三个数值，超出范围会被系统限制

• page：请求页码，系统限制最大20页，超出页码直接返回空数据，用来拦截批量非法采集行为

标准接口访问地址

基础请求路径：index.php/ajax/data.html

带参完整示例链接：index.php/ajax/data.html?mid=1&page=1&limit=10

jQuery异步调用完整示例代码

$.ajax({
type: "POST",
dataType: "JSON",
url: "index.php/ajax/data.html",
data:{mid:1,page:1,limit:10},
success:function(data,status){
console.log(data)
},
error:function(XMLHttpRequest,textStatus,errorThrown){
console.log('接口请求失败');
}
});

代码使用与逻辑讲解

1、请求方式统一使用POST提交，数据返回格式固定为JSON，方便前端循环渲染列表；

2、data内三个参数按需修改mid切换模块、page切换分页、limit调整单页数量；

3、success回调代表接口正常返回数据，控制台打印data可查看影片、文章、专题的标题、封面、简介等全部字段；

4、error回调捕获请求异常，如参数非法、页码超限、服务器报错等场景，可自定义弹窗提示或空白兜底布局；

接口使用注意事项

1、page参数最大仅支持20页，超出后无数据返回，是系统自带的防采集机制，无法通过参数绕过；

2、limit只能填写10、20、30，填写其他数字接口不会正常输出内容；

3、异步加载大量内容时，建议增加加载中占位、无数据兜底判断，提升用户浏览体验；

4、模板内使用该接口时，路径需适配站点伪静态规则，若开启静态重写可根据站点配置调整请求URL。