做网站|网站建设,就上易助科技网

如何使用测试接口

如何使用测试接口

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

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

1.网站栏目相关接口

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

获取栏目树

请求方法:GET

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

请求参数:

返回数据参数:数据格式为 UTF8 JSON

序号
名称
数据类型
示例值
说明
1 id string 栏目id
2 title string 新闻动态 栏目名称
3 type string 图文列表 栏目类型,包括:单页面、标题列表、图文列表、图片列表,type 为 null 通常是指该栏目是一级分类栏目
4 url string www.baidu.com 指向地址
5 remarks string 推荐栏目 备注信息
6 sort int 1 排序(默认为升序)
7 children object "children":[{"id":"202109012127291419384664960003","title":"业内新闻","type":"3","url":"#","remarks":"业内新闻","sort":0,"children":null},{"id":"202109012127291419384664960004","title":"新闻动态","type":"3","url":"#","remarks":"新闻动态","sort":1,"children":null}] 本栏目所包含的子栏目

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

            {
                "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

序号
名称
类型
是否必需
默认值
说明
1 id string 栏目id
请求参数示例:{"id":"202109012127291419384664960001"}

返回数据参数:数据格式为 UTF8 JSON

序号
名称
数据类型
示例值
说明
1 id string 栏目id
2 title string 新闻动态 栏目名称
3 type string 1 栏目类型,包括:单页面、标题列表、图文列表、图片列表,type 为 null 通常是指该栏目是一级分类栏目
4 url string www.baidu.com 指向地址
5 remarks string 推荐栏目 备注信息
6 pageKeyWords string 页面关键词
7 pageDescription string 页面描述信息
8 sort int 1 排序

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

          {
              "status" :  200 ,
              "message" :  "" ,
              "result" :  [{
              "id" :  "202109012127291419384664960001" ,
              "title" :  "关于我们" ,
              "type" :  "单页面" ,
              "url" :  "#" ,
              "remarks" :  "关于我们" ,
              "pageKeyWords" :  "关于我们,易助科技网" ,
              "pageDescription" :  "易助科技网关于我们栏目,为您介绍易助网公司概况,经验理念,发展历程等信息。" ,
              "sort" :  0 }]
          }
        

分页获取栏目分类标签

请求方法:POST

请求地址: https://api.easyzone.net.cn/api/searchTags/query/searchTagsListByTestUser

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

序号
名称
类型
是否必需
默认值
说明
1 columId string 所属栏目id
2 tagName string 分类标签名称查询关键字,支持模糊查询
3 remarks string 标签标注
4 pageIndex int 1 当前页码
5 pageSize int 10 每页显示的数据条数
6 sortField string sort 一级排序字段,默认值为sort创建时间,取值范围:sort(序号)| remarks(标签标注)| createTime(创建时间)
7 sortType string asc 一级排序方式,默认值为asc(升序),取值范围:asc(升序)| desc(降序)
8 secondSortField string 二级排序字段,取值范围:sort(序号)| remarks(标签标注)| createTime(创建时间)
9 secondSortType string asc 二级排序方式,默认值为asc(升序,默认值在提供secondSortField值时有效),取值范围:asc(升序)| desc(降序)
请求参数示例:{"columId":"202109012127291419384664960004","pageIndex":1,"pageSize":10,"sortField":"sort"}

返回数据参数:数据格式为 UTF8 JSON

序号
名称
数据类型
示例值
说明
1 id string 栏目分类标签id
2 belongColum object array [{"id":"2022053016111515827112343441408","columName":"建站资源下载","upId":"0"},{"id":"2022020617210715667220745605120","columName":"网站模板下载","upId":"2022053016111515827112343441408"}] 所属栏目,id-栏目id,columName-栏目名称,upId-上级栏目id(upId="0"代表该栏目为一级栏目,没有上级栏目)
3 tagName string 标签名称 分类标签名称
4 pageKeyWords string 页面关键词
5 pageDescription string 页面描述信息
6 remarks string A 标签分类标注
7 sort int 序号
8 createTime datetime 2021-10-20 15:21:54 创建时间

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

        {
              "status" :  200 ,
              "message" :  "" ,
              "result" :  [{
                  "records" :  3 ,
                  "datas" :  [{
                      "id" :  "2022121615504216110207652696064" ,
                      "title" :  "简洁时尚的通用企业站点模板" ,
                      "imgUrl" :  "https://api.easyzone.net.cn/UserStorage/2021061414571615331587448983552/images/20221216/118135fb0b40477a98da7183a09df51c.jpg" ,
                      "belongColum" :  [{""id":"2022053016111515827112343441408","columName":"建站资源下载","upId":"0"}, {"id":"2022020617210715667220745605120","columName":"网站模板下载","upId":"2022053016111515827112343441408""}] ,
                      "lookSums" :  15 ,
                      "indexLook" :  false ,
                      "source" :  "新闻网" ,
                      "customize1" :  null ,
                      "customize2" :  null ,
                      "customize3" :  null ,
                      "sort" :  0 ,
                      "searchTagsIds" :  [{"id":"2023070415030916393276427784192","tagName":"保健品" }],
                      "createTime" :  "2021-10-20 15:21:54" ,
                      "modifyTime" :  null ,
                      "uploadFileUrl" :  null }...]
                  "pageIndex" :  1 ,
                  "pageSize" :  10 ,
                  "totalPage" :  1 
              }]
          }
        

获取栏目分类标签详细信息

请求方法:POST

请求地址: https://api.easyzone.net.cn/api/newscat/query/searchTagDetailByIdWithTestUser

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

序号
名称
类型
是否必需
默认值
说明
1 id string id
请求参数示例:{"id":"2023070414585816393272325836800"}

返回数据参数:数据格式为 UTF8 JSON

序号
名称
数据类型
示例值
说明
1 id string 栏目分类标签id
2 belongColum object array [{"id":"2022053016111515827112343441408","columName":"建站资源下载","upId":"0"},{"id":"2022020617210715667220745605120","columName":"网站模板下载","upId":"2022053016111515827112343441408"}] 所属栏目,id-栏目id,columName-栏目名称,upId-上级栏目id(upId="0"代表该栏目为一级栏目,没有上级栏目)
3 tagName string 标签名称 分类标签名称
4 pageKeyWords string 页面关键词
5 pageDescription string 页面描述信息
6 remarks string A 标签分类标注
7 sort int 序号
8 createTime datetime 2021-10-20 15:21:54 创建时间

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

        {
              "status" :  200 ,
              "message" :  "" ,
              "result" :  [{
                  "id" :  "2023070414585816393272325836800" ,
                  "belongColum" :  "[{"id":"2022020617210715667220745605120","columName":"网站模板下载","upId":"2022053016111515827112343441408"},{"id":"2022053016111515827112343441408","columName":"建站资源下载","upId":"0"}]" ,
                  "tagName" :  "商城模板" ,
                  "pageKeyWords" :  null ,
                  "pageDescription" :  null ,
                  "remarks" :  "A", 
                  "sort" :  0 ,
                  "createTime" :  "2021-10-20 15:21:54" ,
              }]
          }
        

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

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

请求方法:POST

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

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

序号
名称
类型
是否必需
默认值
说明
1 columId string 栏目id
2 title string 标题名称查询关键字,支持模糊查询
3 indexLook bool 是否推荐,值为true(是)或false(否)
4 pageIndex int 1 当前页码
5 pageSize int 10 每页显示的数据条数
6 sortField string createTime 一级排序字段,默认值为createTime创建时间,取值范围:sort(序号)| lookSums(浏览次数)| createTime(创建时间)| modifyTime(最后修改时间)
7 sortType string ascend 一级排序方式,默认值为desc(降序),取值范围:asc(升序)| desc(降序)
8 secondSortField string 二级排序字段,取值范围:sort(序号)| lookSums(浏览次数)| createTime(创建时间)| modifyTime(最后修改时间)
9 secondSortType string ascend 二级排序方式,默认值为desc(降序,默认值在提供secondSortField值时有效),取值范围:asc(升序)| desc(降序)
请求参数示例:{"columId":"202109012127291419384664960004","pageIndex":1,"pageSize":10,"sortField":"sort"}

返回数据参数:数据格式为 UTF8 JSON 默认以createTime(创建时间)升序排序

序号
名称
数据类型
示例值
说明
1 id string id
2 title string 标题名称
3 imgUrl string 标题配图地址,多种配以","分割
4 colum string 业内新闻 所属栏目
5 lookSums int 10 浏览量
6 indexLook bool false 是否推荐
7 source string 来源
8 customize1 string 用户自定义字段1
9 customize2 string 用户自定义字段2
10 customize3 string 用户自定义字段3
11 sort int 1 排序
12 createTime DateTime 2021-10-20 15:21:54 创建时间
13 modifyTime DateTime 2021-10-20 15:25:54 最后修改时间
14 uploadFileUrl string 附件,多个附件以","分割

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

            {
                "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

序号
名称
类型
是否必需
默认值
说明
1 id string id
请求参数示例:{"id":"2022061610292315850841095770112"}

返回数据参数:数据格式为 UTF8 JSON

序号
名称
数据类型
示例值
说明
1 id string id
2 title string 新闻标题 标题
3 imgUrl string 标题配图地址,多张配图以","分割
4 belongColum object array [{"id":"2022053016111515827112343441408","columName":"建站资源下载","ColumTypeId":null,"upId":"0"},{"id":"2022020617210715667220745605120","columName":"网站模板下载","ColumTypeId":"3","upId":"2022053016111515827112343441408"}] 所属栏目,id-栏目id,columName-栏目名称,ColumTypeId-栏目类型id(1-单页面,2-标题列表,3-图文列表,4-图片列表),upId-上级栏目id(upId="0"代表该栏目为一级栏目,没有上级栏目)
5 searchTags object array [{"id":"2023070415030916393276427784192","tagName":"保健品"}] 所属栏目分类标签
6 contents string 内容
7 lookSums int 0 浏览量
8 indexLook bool false 是否推荐
9 source string 来源
10 customize1 string 用户自定义字段1
11 customize2 string 用户自定义字段2
12 customize3 string 用户自定义字段3
13 createTime DateTime 2021-10-20 15:21:54 创建时间
14 modifyTime DateTime null 最后修改时间
15 uploadFileUrl string 附件,多个附件以","分割
16 sort int 序号

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

            {
                "status" :  200 ,
                "message" :  "" ,
                "result" :  [{
                    "id" :  "2023072702285816425093331177472" ,
                    "title" :  "韩国一公斤牛肉1090元!经济学家称恶性通胀来了" ,
                    "imgUrl" :  null ,
                    "belongColum" :  "[{"id":"2022053016111515827112343441408","columName":"建站资源下载","ColumTypeId":null,"upId":"0"},{"id":"2022020617210715667220745605120","columName":"网站模板下载","ColumTypeId":"3","upId":"2022053016111515827112343441408"}]" ,
                    "searchTags" :  "[{"id":"2023070415030916393276427784192","tagName":"保健品"}]" ,
                    "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

序号
名称
类型
是否必需
默认值
说明
1 id string id
请求参数示例:{"id":"2022061610292315850841095770112"}

返回数据参数:数据格式为 UTF8 JSON

序号
名称
数据类型
示例值
说明
1 bool true 返回的布尔值代表操作是否成功。

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

            {
                "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

序号
名称
类型
是否必需
默认值
说明
1 title string 根据链接项目名称,如:"友情链接",获取该项目下链接信息(设置项目名称时请务必不要重名)。
2 pageIndex int 1 当前页码
3 pageSize int 10 每页显示的数据条数
请求参数示例:{"title":"友情链接","pageIndex":1,"pageSize":10}

返回数据参数:数据格式为 UTF8 JSON

序号
名称
数据类型
示例值
说明
1 type string 文字链接 项目类型,包括:文字链接 | 图片链接
2 title string 当链接为文字链接时,该字段代表链接文字;当链接为图片链接时,该字段代表链接名称
3 sourceUrl string 当链接为文字链接时,该字段无效;当链接为图片链接时,该字段代表图片地址
4 toUrl string https:www.baidu.com 指向地址
5 sort int 1 排序
6 createTime DateTime 2021-10-29 02:39:42 创建时间

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

          {
              "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

序号
名称
类型
是否必需
默认值
说明
1 name string 匿名用户 留言者名称,小于50个字符。
2 contact string 联系方式,小于100个字符。
3 message string 留言内容,小于300个字符。

返回数据参数:数据格式为 UTF8 JSON

序号
名称
数据类型
示例值
说明
1 bool true 返回的布尔值代表操作是否成功。
请求参数示例:{"name":"张先生","contact":"13812345678","message":"在线留言"}

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

          {
              "status" :  200 ,
              "message" :  "" ,
              "result" :  true
          }
        
已成功复制到剪切板
复制失败,请检查浏览器设置