@@@待完善@@@

简要描述：

  • 获取所有文章的概述, 或者获取指定分类的文章概述

请求域名:

  • http://test.yunzshop.com

请求URL:

GET/addons/yun_shop/api.php?i=2&mid=null&type=5&route=plugin.article.api.article.get-articles

参数:

参数名 是否必须 类型 说明
i 是 int 店铺ID
category_id int 文章分类的分类ID(如果提供, 返回该指定分类ID的文章; 如果不提供,则返回所有文章)
keyword 否 string 搜索关键词

返回示例:

正确时返回:

{
    "result": 1, 
    "msg": "获取文章和分类数据成功", 
    "data": {
        "title": "文章标题", 
        "banner": "http://test.yunzshop.com/attachment/images/2/2017/05/JTcT2aWa2na992NQfpP02J4HKZHYfc.png", 
        "template_type": "3", 
        "categories": [
            {
                "id": 4, 
                "name": "功能介绍", 
                "member_level_id_limit": 1
            }, 
            {
                "id": 5, 
                "name": "广告", 
                "member_level_id_limit": 0
            }, 
            {
                "id": 6, 
                "name": "测试lll", 
                "member_level_id_limit": 23
            }
        ], 
        "articles": {
            "total": 4, 
            "per_page": "15", 
            "current_page": 1, 
            "last_page": 1, 
            "next_page_url": null, 
            "prev_page_url": null, 
            "from": 1, 
            "to": 4, 
            "data": [
                {
                    "id": 35, 
                    "title": "小程序从媳妇熬成婆，靠的是什么？", 
                    "thumb": "http://test.yunzshop.com/attachment/images/2/2017/04/HQW88VWWTA45JqNaANAn8D8QC4dvxn.png", 
                    "desc": "自1月9号微信小程序正式发布以来"
                }, 
                {
                    "id": 20, 
                    "title": "457857", 
                    "thumb": "http://test.yunzshop.com/attachment/images/2/2017/03/tFTw02YyQsZ442yWf42n7Y0O12zA2O.png", 
                    "desc": ""
                }, 
                {
                    "id": 17, 
                    "title": "saFedg", 
                    "thumb": "", 
                    "desc": ""
                }, 
                {
                    "id": 12, 
                    "title": "人物丨这个83岁老人仅一米五，却在街头用高难度舞蹈惊呆路人，征服了世界!", 
                    "thumb": "http://gjb.antbiz.cn/tutu/xibRC2eoiaqM6pA6usuVnb3RbBGdNOODuia17bNRJs6xtSkrjzuib3zRQbDzXuabCJKDNuzBvbotDnqCzariczic0iadA/640", 
                    "desc": "我们不过是尚待完善的残片，想要圆满，就去拼搏。"
                }
            ]
        }
    }
}

错误时返回:

如果"文章营销"的功能已经被关闭:

{
    "result": 0,
    "msg": "文章已经关闭!",
    "data": [ ]
}

{
    "result": 0,
    "msg": "没有文章!",
    "data": [ ]
}

{
    "result": 0,
    "msg": "对不起, 您所在的地理区域暂无阅读文章的权限!",
    "data": [ ]
}

返回参数说明:

参数名 类型 说明
id int 分类ID
name string 分类名称
member_level_id_limit int 限制会员等级ID下会员阅读
参数名 类型 说明
title str 文章列表标题
banner str 文章列表的 banner
template_type int 文章样式类型, 1 代表"默认模板(列表)", 2 代表"历史消息样式", 3 代表"分类列表样式"
categories mix 所有文章分类的信息
articles mix 所有文章的详细信息
参数名 类型 说明
total int 分类总条数
per_page int 每页条数
current_page int 当前页码
last_page int 最后一页的页码 URL
next_page_url string 下一页URL
prev_page_url string 上一页URL
from int 第几条开始
to int 第几条结束
id int 文章ID
uniacid int 公众号ID
category_id int 文章分类ID
title string 文章标题(主要显示字段)
desc string 封面描述 (主要显示字段)
thumb string 封面图片(主要显示字段)

备注:

  • 参数category_id不为0时，为选中分类下的文章列表，否则为全部文章列表
  • 显示的阅读数量 = 真实阅读数 + 虚拟阅读数
  • 显示的点赞数量 = 真实点赞数 + 虚拟点赞数