如何使用测试接口

为了方便您的网站开发，我们为您提供免费的测试接口用于开发调试您的网站。测试接口与正式接口在请求方法、请求参数、返回参数和返回值等方面基本一致，只是请求地址和部分请求参数不相同，在开发完成后只需要按具体情况稍作修改即可正常使用。为了方便您的使用，测试接口无需绑定域名，使用本地开发环境就可以获取相关数据。

如果您的网站比较简单，您可以使用promise封装ajax异步请求接口数据， 查看说明。如何您使用的是vue、react等前端框架，请使用框架提供请求数据方法，如：vue的$http方法请求数据。

1.网站栏目相关接口

网站栏目是指网站的一级、二级导航栏目，本系统现只提供二级栏目接口数据。

获取栏目树

请求方法：GET

请求地址： https://api.easyzone.net.cn/api/newscat/query/columsTableTreeByTestUser 复制

请求参数：无

返回数据参数：数据格式为 UTF8 JSON

 返回示例： 返回示例仅供参考，以测试结果为准。 查看返回数据的详细信息 

            {
                "status" :  200 ,
                "message" :  "" ,
                "result" :  [{
                "id" :  "202109012127291419384664960001" ,
                "title" :  "关于我们" ,
                "type" :  "单页面" ,
                "url" :  "#" ,
                "remarks" :  "关于我们" ,
                "sort" :  0 ,
                "children" :  null }...]
            }
          

获取栏目详细信息

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newscat/query/columDetailByIdWithTestUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

 返回数据参数：数据格式为 UTF8 JSON

 返回示例： 返回示例仅供参考，以测试结果为准。 查看返回数据的详细信息 

            {
                "status" :  200 ,
                "message" :  "" ,
                "result" :  [{
                "id" :  "202109012127291419384664960001" ,
                "title" :  "关于我们" ,
                "type" :  "单页面" ,
                "url" :  "#" ,
                "remarks" :  "关于我们" ,
                "sort" :  0 }]
            }
          

2.网站发布内容相关接口

 分页获取指定栏目下内容列表

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newsrelease/query/newsListByColumWithTestUser 复制

 请求参数： 请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据参数：数据格式为 UTF8 JSON 默认以createTime（创建时间）升序排序

 返回示例： 返回示例仅供参考，以测试结果为准。 查看返回数据的详细信息 

            {
                "status" :  200 ,
                "message" :  "" ,
                "result" :  [{
                    "records" :  3 ,
                    "datas" :  [{
                        "id" :  "2021102015215415512805597630464" ,
                        "title" :  "韩国一公斤牛肉1090元！经济学家称恶性通胀来了" ,
                        "imgUrl" :  null ,
                        "colum" :  "业内新闻" ,
                        "lookSums" :  15 ,
                        "indexLook" :  false ,
                        "source" :  "新闻网" ,
                        "customize1" :  null ,
                        "customize2" :  null ,
                        "customize3" :  null ,
                        "sort" :  0 ,
                        "createTime" :  "2021-10-20 15:21:54" ,
                        "modifyTime" :  null ,
                        "uploadFileUrl" :  null }...]
                    "pageIndex" :  1 ,
                    "pageSize" :  10 ,
                    "totalPage" :  1 
                }]
            }
          

获取发布内容详细信息

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newsrelease/query/newsReleaseDetailByIdWithTestUser 复制

 请求参数： 请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据参数：数据格式为 UTF8 JSON

 返回示例： 返回示例仅供参考，以测试结果为准。 查看返回数据的详细信息

            {
                "status" :  200 ,
                "message" :  "" ,
                "result" :  [{
                    "title" :  "韩国一公斤牛肉1090元！经济学家称恶性通胀来了" ,
                    "imgUrl" :  null ,
                    "newsColumId" :  "202109012127291419384664960003" ,
                    "newsColumName" :  "业内新闻" ,
                    "contents" :  "<div><p>日本经济学家认为，目前的通货膨胀属于恶性通货膨胀，在经济低迷的情况下，由于原油价格上涨等原因导致物价上涨，但工资却没有上涨，通胀无法刺激消费。</p></div><div><p>（原标题：“蛋白通胀”？亚洲多国民众叫苦</p></div>"
                    "lookSums" :  0 ,
                    "indexLook" :  false ,
                    "source" :  "" ,
                    "customize1" :  "" ,
                    "customize2" :  "" ,
                    "customize3" :  "" ,
                    "sort" :  0 ,
                    "createTime" :  "2021-10-20 15:21:54" ,
                    "modifyTime" :  null ,
                    "uploadFileUrl" :  null 
                }]
            }
          

浏览量 +1 操作

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newsrelease/update/lookSumsByIdWithTestUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据参数：数据格式为 UTF8 JSON

返回示例：返回示例仅供参考，以测试结果为准。查看返回数据的详细信息

            {
                "status" :  200 ,
                "message" :  "" ,
                "result" :  true
            }
          

3.链接项目相关接口

链接项目用来管理您网站中如：友情链接、滚动图片等动态发布的文字和图片信息。返回数据一级排序为：sort 降序，二级排序为：createTime（创建时间）降序。

分页获取指定项目下链接信息

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/linkprojects/query/linkListByNameWithTestUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据参数：数据格式为 UTF8 JSON

返回示例：返回示例仅供参考，以测试结果为准。查看返回数据的详细信息

            {
                "status" :  200 ,
                "message" :  "" ,
                "result" :  [{
                    "records" :  2 ,
                    "datas" :  [{
                        "type" :  "文字链接" ,
                        "title" :  "百度" ,
                        "sourceUrl" :  null ,
                        "toUrl" :  "https:www.baidu.com" ,
                        "sort" :  0 ,
                        "createTime" :  "2021-10-29 02:39:42" 
                    }...]
                    "pageIndex" :  1 ,
                    "pageSize" :  10 ,
                    "totalPage" :  1 
                }]
            }
          

4.在线留言相关接口

创建在线留言信息

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/onlinemessage/createByTestUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据参数：数据格式为 UTF8 JSON

返回示例：返回示例仅供参考，以测试结果为准。查看返回数据的详细信息

            {
                "status" :  200 ,
                "message" :  "" ,
                "result" :  true
            }
          

如何使用正式接口

在使用正式接口前 查看说明 ，您要将您的网站地址在【用户中心】-【设置绑定域名】中将域名进行绑定，并在【用户中心】-【获取keys】中，生成并获取keys。正式接口的返回参数和返回值与测试接口是相同的，但是请求参数和请求地址有所不相同。

1.网站栏目相关接口

获取栏目树

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newscat/query/columsTableTreeByUser 复制

请求参数：参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据和示例：请参阅测试接口

获取栏目详细信息

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newscat/query/columDetailByIdWithUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据和示例：请参阅测试接口

2.网站发布内容相关接口

分页获取指定栏目下内容列表

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newsrelease/query/newsListByColumWithUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据和示例：请参阅测试接口

获取发布内容详细信息

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newsrelease/query/newsReleaseDetailByIdWithUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据和示例：请参阅测试接口

浏览量 +1 操作

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/newsrelease/update/lookSumsByIdWithUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据和示例：请参阅测试接口

3.链接项目相关接口

链接项目用来管理您网站中如：友情链接、滚动图片等动态发布的文字和图片信息。返回数据一级排序为：sort 降序，二级排序为：createTime（创建时间）降序。

分页获取指定项目下链接信息

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/linkprojects/query/linkListByNameWithUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据和示例：请参阅测试接口

4.在线留言相关接口

创建在线留言信息

请求方法：POST

请求地址： https://api.easyzone.net.cn/api/onlinemessage/createByUser 复制

请求参数：请求参数为JSON格式对象，参数名称大小写敏感，Content-Type为：application/json;charset=UTF-8

返回数据和示例：请参阅测试接口

栏目设置

栏目及栏目类型的含义

栏目是用来为您的网站内容进行分类的，可以等同于网站的导航。栏目类型是本系统根据内容特点将栏目划分成的不同种类，暂包括以下四个类型：

1. 单页面：

单页面栏目是指只有一级内容，所有内容都包含在当前页面中的栏目，如：关于我们、联系我们等类型页面。

2. 标题列表：

标题列表栏目是指包含有二级内容，一级为文字链接列表，点击链接后将指向详细内容页面的栏目，如：通知公告、法律法规等类型页面。

3. 图文列表：

图文列表栏目与标题列表栏目相似，只是每个标题包含有配图，该类型栏目也包含有二级内容，一级为文字和配图链接列表，点击链接后将指向详细内容页面的栏目，如：新闻资讯等类型页面。

4. 图片列表：

图片列表栏目也与标题列表栏目相似，只是以图片作为标题，该类型栏目也包含有二级内容，一级为图片链接列表，点击链接后将指向详细内容页面的栏目，如：企业相册等类型页面。

内容发布

网站需发布的内容，如：新闻、资讯、通知、公告等内容。

图片处理

如果您的发布内容中有图片、文件等内容，您可以使用ftp等软件将这些静态资源上传到您网站服务器，然后将其地址在后台管理系统中输入并保存，或者您也可以先购买我们磁盘，然后在后台管理系统中直接将这些资源上传到您购买的磁盘中。

删除发布内容

如果您购买了我们的磁盘，在您删除相关发布内容时，服务器会自动删除上传配图、附件等静态资源，但是富文本编辑器中图片，任需要您手动在【站内资源管理】-【存储磁盘管理】中删除。富文本编辑器是指下图所示区域：

上传内容类型

现在本系统只能上传图片和压缩附件（.zip格式），如果你的网站需要使用视频等其他类型资源，请先将它们上传到您的网站服务器，然后将地址输入到发布内容中。

链接项目

链接项目是用来管理您网站中使用的诸如：轮播图片、友情链接、广告图片等类似内容。

创建链接项目方法

1. 【链接项目管理】-【项目管理】中创建项目；

2. 【链接项目管理】-【文字链接】或【链接项目管理】-【图片链接】中创建不同类型链接内容。

创建链接项目

根据内容在【链接项目管理】-【项目管理】中创建相应项目如：友情链接。现在本系统暂时只能创建文字链接和图片两类链接项目，文字链接项目如：友情链接，图片链接项目如：首页轮播图片。

创建链接内容

根据您要创建链接的不同类型，分别在【链接项目管理】-【文字链接】或【链接项目管理】-【图片链接】中创建不同类型链接内容。

注：在创建链接时，需要先选择所属项目。

接口返回数据的详细信息

由接口返回的是JSON结构数据，包含的字段及含义如下：

1. status 状态码

类型：int

含义：表示返回数据是否成功，200 代表成功，其他为错误代号。查看状态码列表

2. message 消息

类型：string

含义：返回的消息，通常为错误或失败的原因或提示信息。

3. result 返回结果

类型：string

含义：返回结果,根据不同结果类型，result 通常有以下几种情况：

A. 返回结果为单条数据时，result 为对象，示例：

"result" : { "id" : "202109012127291419384664960001", "title" : "关于我们", "type" : "单页面", "url" : "#", "remarks" : "关于我们", "sort" : 0 }

B. 返回结果为多条数据时，result 为对象数组，示例：

"result" : [

{ "id" : "202109012127291419384664960001", "title" : "关于我们", "type" : "单页面", "url" : "#", "remarks" : "关于我们", "sort" : 0, "children" : null },

{ "id" : "202109012127291419384664960002", "title" : "资讯中心", "type" : null, "url" : "#", "remarks" : "资讯中心", "sort" : 1, "children" : null }...]

C. 返回结果为分页查询数据时，result 为嵌套对象，records 字段表示返回数据的总条数，datas 字段表示返回的数据实体，pageIndex 字段表示当前页码，pageSize 字段表示每页显示的数据条数，totalPage 表示总页数。示例：

"result" : { "records" : 3, ,"pageIndex" : 1, "pageSize" : 10, "totalPage" : 1, "datas" : [

{ "id" : "2021102015215415512805597630464", "title" : "韩国一公斤牛肉1090元！经济学家称恶性通胀来了", "imgUrl" : null, "colum" : "业内新闻", "sort" : 0,"createTime" : "2021-10-20 15:21:54" ,"modifyTime" : null }...]}

4. 错误状态码