CMS模块内置了所有api接口,各个接口的调用方法基本与模板标签库一致,在使用API之前你需要在后台做一个简单的API配置,如下图: >[info] 每个配置项的右侧都有相应的解释,照着说明设置即可。 ![](https://box.kancloud.cn/e41db0b7698a94c70d6a8a1a47467fe4_1966x1264.png) >[danger] 友情提示:以下所有示例代码均是在API签名验证状态为禁用情况下。 ## 内容列表 >[info]接口地址:/cms/api/list 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | cid | int/var | 是 | 0 | 分类ID,cid和mid最少传一个 | | mid | int/var | 是 | 0 | 模型ID,cid和mid最少传一个 | | orderby | string | 否 | id desc | 结果排序 | | attr | string/array | 否 | | 扩展属性 | | keyword | string/var | 否 | | 通过关键字搜索title | | limit | int | 否 | 20 | 返回结果条数 | | pagesize | int | 否 | 0 | 分页大小 | | field | string | 否 | | 设置返回的字段 | | flag | string | 否 | | 通过推荐旗帜筛选内容 | | tag | string | 否 | | 通过标签筛选内容 | | where | string/array | 否 | | 自定义查询条件 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/list', data: { cid: 49, pagesize: 20, orderby: 'view desc' }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'POST', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/list', { cid: 49, pagesize: 20, orderby: 'view desc' }, function(res) { console.log(res); }, 'json'); ``` ## 内容详情 >[info]接口地址:/cms/api/detail 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | id | int | 是 | | 内容ID | >[info] 示例代码: ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/detail', data: { id: 49 }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'POST', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/detail', { id: 49 }, function(res) { console.log(res); }, 'json'); ``` ## 栏目列表 >[info]接口地址:/cms/api/category 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | cid | int/var | 是 | 0 | 分类ID,cid和mid最少传一个 | | mid | int/var | 是 | 2 | 模型ID,cid和mid最少传一个 | | level | int | 否 | 0 | 返回层级数,0为不限制 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/category', data: { cid: 49, level: 3 }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/category', { cid: 49, level: 3 }, function(res) { console.log(res); }, 'json'); ``` ## 标签 >[info]接口地址:/cms/api/tag 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | mid | int/var| 是 | | 指定模型ID | | orderby | string | 否 | search\_count desc | 排序 | | limit | int | 否 | 10 | 限制返回数量 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/tag', data: { mid: 2, limit: 15 }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/tag', { mid: 2, limit: 15 }, function(res) { console.log(res); }, 'json'); ``` ## 碎片块 >[info]接口地址:/cms/api/block 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | name | string | 是 | | 碎片名称 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/block', data: { name: 'about' }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/block', { name: 'about' }, function(res) { console.log(res); }, 'json'); ``` ## 导航 >[info]接口地址:/cms/api/nav 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | group | string | 否 | | 返回指定分组 | | limit | int | 否 | 10 | 限制返回数量 | | cache | bool | 否 | false | 缓存结果集 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/nav', data: { group: 'home' }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/nav', { group: 'home' }, function(res) { console.log(res); }, 'json'); ``` ## 友情链接 >[info]接口地址:/cms/api/link 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | type | string | 是 | | 类型,可选值:image,text,all | | group | string | 否 | | 返回指定分组 | | orderby | string | 否 | sort asc | 排序 | | limit | int | 否 | 10 | 限制返回数量 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/link', data: { type: 'text', group: 'home' }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/link', { type: 'text', group: 'home' }, function(res) { console.log(res); }, 'json'); ``` ## 幻灯片 >[info]接口地址:/cms/api/slide 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | type | string | 否 | pc | 类型,可选值:pc,wap | | group | string | 否 | | 返回指定分组 | | orderby | string | 否 | sort asc | 排序 | | limit | int | 否 | 10 | 限制返回数量 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/slide', data: { type: 'wap', group: 'home' }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/slide', { type: 'wap', group: 'home' }, function(res) { console.log(res); }, 'json'); ``` ## 推荐:rec >[info]接口地址:/cms/api/rec 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | name | string | 是 | | 调用名称 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/rec', data: { name: 'product' }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/rec', { name: 'product' }, function(res) { console.log(res); }, 'json'); ``` ## 栏目类型 >[info]接口地址:/cms/api/type 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | tid | int | 是 | | 类型ID | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/type', data: { tid: 123 }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/type', { tid: 123 }, function(res) { console.log(res); }, 'json'); ``` ## 表单 >[info]接口地址:/cms/api/form 请求方式:GET/POST | 属性名 | 类型 | 必须 | 默认 | 说明 | --- | --- | --- | --- | --- | | name | string | 是 | | 表单名称 | >[info] 示例代码 ``` /* 微信小程序示例 */ wx.request({ url: 'https://cms.hisiphp.com/cms/api/form', data: { name: 'test' }, header: { 'content-type': 'application/x-www-form-urlencoded' }, method: 'GET', success: function (res) { console.log(res); } }); /* jquery示例 */ $.get( '/cms/api/form', { name: 'test' }, function(res) { console.log(res); }, 'json'); ```