goods/list.json
## 请求参数
| 参数名称 | 类型 | 示例值 | 必须 | 描述 |
| ------------ | ------------ | ------------ | ------------ | ------------ |
| storeid | int | 1 | 是 | 商铺编号，要获取的数据是属于哪个商铺的 |
| typeid | int | 1 | 否 | 哪个分类的商品。如果不传，则是查询这个商店中所有的商品 |
| title | String | 白菜 | 否 | 要搜索的商品名字,可模糊搜索。
比如搜索白菜，可以搜索白菜花、白菜叶、白菜根 |
| orderBy | int | 1 | 否 | 返回商品列表的排序方式
0: 默认排序方式，也就是根据商家后台自定义的商品排序，来进行的排序
1: 按总销量由高往低来排序
2: 最新商品，按发布时间，由高往低来排序，最后发布的商品在最前面。
如果不传此参数，默认按照 0 进行排序 |
| everyNumber | int | 15 | 否 | 每页显示多少条数据。取值 1～100，最大显示100条数据，若传入超过100，则只会返回100条。
若不传，默认显示15条 |
| currentPage | int | 1 | 否 | 要获取第几页的列表数据，如要查看第2页，则这里传入 2。如果不传，默认获取第一页的 |
| token | String | dff4214c-4eca-42b8-ad9c-b95afd6374c0 | 否 | 当前操作用户的唯一标识。可用 [login/getToken.json](19770.html) 获取 |
## 返回结果
#### 返回示例
````
{
"result": 1,
"info": "成功",
"list": [
{
"id": 8,
"title": "花生",
"inventory": 10,
"putaway": 1,
"sale": 0,
"units": "",
"price": 300,
"originalPrice": 800,
"addtime": 1581986730,
"storeid": 1,
"typeid": 1,
"titlepic": "http://www.xxxx.com/123.jpg ",
"userBuyRestrict": 0,
"specification":"[{"黄色":90.1},{"黑色":80},{"白色":70.5}]"
},
{
"id": 9,
"title": "土豆",
"inventory": 500,
"putaway": 1,
"sale": 0,
"units": "个",
"price": 900,
"originalPrice": 800,
"addtime": 1581987167,
"storeid": 1,
"typeid": 1,
"titlepic": "http://www.xxxx.com/123.jpg ",
"userBuyRestrict": 0,
"specification":"[]"
}
],
"page": {
"limitStart": 4,
"allRecordNumber": 8,
"currentPageNumber": 3,
"everyNumber": 2,
"lastPageNumber": 4,
"nextPage": "...",
"upPage": "...",
"lastPage": "...",
"firstPage": "...",
"haveNextPage": true,
"haveUpPage": true,
"currentLastPage": false,
"currentFirstPage": false,
"upPageNumber": 2,
"nextPageNumber": 4,
"upList": [
{
"href": "...",
"pageNumber": 1,
"title": "1"
},
{
"href": "...",
"pageNumber": 2,
"title": "2"
}
],
"nextList": [
{
"href": "...",
"pageNumber": 4,
"title": "4"
}
]
}
}
````
#### 返回字段说明
| 参数名称 | 类型 | 示例值 | 描述 |
| ------------ | ------------ | ------------ | ------------ |
| result | int | 1 | 执行情况。
1:执行成功;
0:执行失败 |
| info | String | success | 若result为0，这里返回失败的原因
若result为1，是执行成功，这里没有什么用 |
| list | JSONArray | | 商品列表 |
| page | JSONObject | | 分页信息 |
##### list 中每项的值说明
| 参数名称 | 类型 | 示例值 | 描述 |
| ------------ | ------------ | ------------ | ------------ |
| id | int | 1 | 商品的id编号 |
| title | String | 猪肉 | 商品的名称 |
| inventory | int | 100 | 库存数量，有多少库存 |
| putaway | int | 1 | 是否上架在售，1出售中，0已下架 |
| sale | int | 10 | 已售数量。这个并不是真实的数量，有假的数量在内。这里是真实的已售数量跟商家管理后台中编辑商品时，自定义增加的假销售数量的和 |
| units | String | 个 | 计量单位。如个、斤、条，限制5字符 |
| price | int | 100 | 单价，单位是分，购买需要支付的价格 |
| originalPrice | int | 100 | 原价，单位是分，仅仅只是看的，使用场景一般就是 显示出来一个原价，加一条删除线的效果 |
| addtime | int | 1581919619 | 商品添加时间，10位时间戳 |
| storeid | int | 1 | 店铺的id，该商品是属于哪个店铺的 |
| typeid | int | 1 | 分类的id，该商品所属哪个分类的 |
| titlepic | String | http://www.xxxx.com/123.jpg | 商品的标题图片（列表图片）比如在商品列表页面中所显示的商品图 |
| userBuyRestrict | int | 0 | 用户购买限制。如果值是0，则可以任意购买，没有什么限制，如果是1，则代表每个用户只能购买一个，如果是2，代表每个用户只能购买2个以内，不超过2个。 只要是下单了，未退单成功的，都算是购买了 |
| specification | String | [{"黄色":90.1},{"黑色":80}] | 商品的规格、型号，v1.6版本增加。
比如商品是衣服，这里就可以是 黑色、黄色 等颜色的。里面的数据格式为JSONArray类型。
其中 key是对用户显示的规格文字， value是这个规格的价格，float类型 |
##### page 中每项的值说明
| 参数名称 | 类型 | 示例值 | 描述 |
| ------------ | ------------ | ------------ | ------------ |
| allRecordNumber | int | 30 | 列表总共有多少条信息 |
| currentPageNumber | int | 1 | 当前第几页，当前的页数 |
| lastPageNumber | int | 5 | 最后一页的页码、共有多少页 |
| haveUpPage | Boolean | true | 是否有上一页 |
| haveNextPage | Boolean | true | 是否有下一页 |
| upList | JSONArray | | 上几页，如果有上几页，这里才会有数据，最多显示当前页数向前的三页。 |
| nextList | JSONArray | | 下几页，如果有下几页，这里才会有数据，最多显示当前页数向后的三页。 |
##### upList、nextList 中每项的值说明
| 参数名称 | 类型 | 示例值 | 描述 |
| ------------ | ------------ | ------------ | ------------ |
| pageNumber | int | 3 | 上几页中，其中某页的页数 |