简要描述
请求url
https://www.商城域名.com/index.php?s=/api/article/list
请求方式
是否需授权登录
请求header
参数名 |
类型 |
是否必须 |
示例值 |
说明 |
storeId |
int |
必填 |
10001 |
商城ID |
platform |
string |
必填 |
H5 |
当前请求的客户端(APP、小程序、H5等) |
Access-Token |
string |
选填 |
- |
当前登录用户的 Token |
请求参数
参数名 |
类型 |
是否必须 |
示例值 |
说明 |
categoryId |
int |
选填 |
10001 |
分类ID |
返回示例
{
"status": 200,
"message": "success",
"data": {
"list": {
"total": 2,
"per_page": 15,
"current_page": 1,
"last_page": 1,
"data": [{
"article_id": 10002,
"title": "为何新iPhone降至4999也没热度?有人表示不如旅游或买服装",
"show_type": 10,
"category_id": 10001,
"image_id": 10216,
"sort": 100,
"status": 1,
"virtual_views": 100,
"actual_views": 9,
"image_url": "20190119125731fa15b3797.jpg",
"category": {
"category_id": 10001,
"name": "手机",
"status": 1,
"sort": 100
},
"show_views": 109
}, {
"article_id": 10003,
"title": "麒麟980+8G+徕卡三摄,这款才是华为“最强旗舰”,别听导购忽悠",
"show_type": 10,
"category_id": 10001,
"image_id": 10215,
"sort": 100,
"status": 1,
"virtual_views": 100,
"actual_views": 33,
"image_url": "20190119125452842158477.jpg",
"category": {
"category_id": 10001,
"name": "手机",
"status": 1,
"sort": 100
},
"show_views": 133
}]
}
}
}
返回参数
参数名 |
类型 |
示例值 |
说明 |
status |
int |
200 |
请求状态(200:请求成功;500:请求错误/失败) |
message |
string |
success |
请求结果的信息,默认为 success |
data |
object |
- |
返回的业务数据 |
data 参数
参数名 |
类型 |
示例值 |
说明 |
list |
object |
- |
列表数据 |
data.list 参数
参数名 |
类型 |
示例值 |
说明 |
total |
int |
2 |
总记录数 |
per_page |
int |
15 |
每页记录数 |
current_page |
int |
1 |
当前页码 |
last_page |
int |
1 |
最后页码 |
data |
array |
- |
列表数组 |
data.list.data 参数
参数名 |
类型 |
示例值 |
说明 |
article_id |
int |
10002 |
文章ID |
title |
string |
为何新iPhone降至4999也没热度?有人表示不如旅游或买服装 |
文章标题 |
show_type |
int |
10 |
列表显示方式 (10小图展示 20大图展示) |
category_id |
int |
10001 |
文章分类ID |
image_id |
int |
10216 |
封面图ID |
sort |
int |
100 |
文章排序 (数字越小越靠前) |
status |
int |
1 |
文章状态 (0隐藏 1显示) |
image_url |
string |
20190119125731fa15b3797.jpg |
封面图URL |
category |
object |
- |
文章分类信息 |
show_views |
int |
109 |
显示的浏览次数(虚拟阅读量+实际阅读量) |
data.list.data.category 参数
参数名 |
类型 |
示例值 |
说明 |
category_id |
int |
10001 |
分类ID |
name |
string |
手机 |
分类名称 |
status |
int |
1 |
分类状态(1显示 0隐藏) |
sort |
int |
100 |
排序方式(数字越小越靠前) |