## 获取店铺列表(storeList) >[info] 场景说明:获取商城正常营业的店铺列表 ### 是否需要获取用户TOKEN `否` ***** ### 请求地址 ``` POST http://api.xxx.com/store/list ``` ### 公共请求参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | appid | string | 必须 | 平台提供的唯一APPID | | version | string | 必须 | 接口版本号,固定填:v3 | | sign\_type | string | 必须 | 签名类型,目前只支持md5 | | timestamp | string | 必须 | 发起时间戳,格式为:yyyy-mm-dd hh::ii::ss | | format | string | 必须 | 返回的数据格式,只支持json | | sign | string | 必须 | 请求参数的签名,请参考:[签名规则](signature.md) | | token | string | 必须 | 访问TOKEN | | params | string | 必须 | 请求参数的集合,除公共参数外,所有请求参数都必须放在这个参数中传递,json\_encode后送入 | 应用请求参数`params`格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | cate\_id | integer | 可选 | 店铺分类ID,包含下级分类的店铺 | | keyword | string | 可选 | 关键词搜索 | | region\_id | integer | 可选 | 店铺所在地区ID(包含下级地区ID) | | stype | string | 可选 | 主体类型,"company"=企业,"personal"=个人。如果不传,则不限制 | | sgrade | integer | 可选 | 店铺等级,如果不传,则不限制 | | praise\_rate | decimal | 可选 | 店铺好评率,取值:0-100,如果不传则不限制 | | orderby | string | 可选 | 排序,参考下文:排序取值说明 | | page | integer | 可选 | 当前页 | | page\_size | integer | 可选 | 每页读取多少条记录,默认10条 | >[info] orderby排序取值说明:"credit\_value"=信用等级从高到低,"praise\_rate|desc"=好评率从高到低,"add\_time|desc"=开店时间从近到远 ### 请求示例 ``` { "appid": "您的APPID", "version": "v3", "sign_type": "md5", "timestamp": "2020-8-10 12:00:00", "format": "json", "sign": "op0987yhjmngt54rtg2wgdfvcder2765", "params": { "cate_id": 21, "orderby": "credit_value|desc" } } ``` ***** ### 公共返回参数 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | code | integer | 必须 | 0=成功,其它值代表请求失败的错误代码,请参考:[公共错误码](response-code.md) | | message | string | 必须 | 请求成功/失败的描述信息 | | \+ data | array | 必须 | 返回结果,如果没有数据则返回空 | | └ list | list | 必须 | 店铺列表 | | └ pagination | array | 必须 | 分页信息 | 返回`data->list`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | store\_id | integer | 必须 | 店铺ID | | store\_name | string | 必须 | 店铺名称 | | cate\_id | integer | 必须 | 店铺分类ID | | cate\_name | string | 必须 | 店铺分类名称 | | store\_logo | string | 必须 | 店铺LOGO | | credit\_image | string | 必须 | 店铺等级图标 | | region\_id | integer | 必须 | 店铺所在地区ID | | province | string | 可选 | 店铺所在省 | | city | string | 可选 | 店铺所在市 | | district | string | 可选 | 店铺所在区 | | address | string | 可选 | 店铺详细地址(不含省市区) | | tel | string | 可选 | 店铺联系电话 | | im\_qq | string | 可选 | 店铺联系QQ | | stype | string | 必须 | 主体类型,"company"=企业,"personal"=个人 | | sgrade | integer | 必须 | 店铺等级 | | credit\_value | integer | 必须 | 店铺信用度值 | | praise\_rate | decimal | 必须 | 店铺好评率,取值:0-100 | | goods\_count | integer | 必须 | 店铺在售商品数 | | collects | integer | 必须 | 店铺被收藏数 | | add\_time | string | 必须 | 开店时间,格式:yyyy-mm-dd hh:ii:ss | 返回`data->pagination`参数格式 | 字段 | 类型 | 是否必填 | 描述 | | --- | --- | --- | --- | | page | integer | 必须 | 当前页 | | page\_size | integer | 必须 | 每一页显示的数据量 | | page\_count | integer | 必须 | 总页数 | | total | integer | 必须 | 总记录数 | ### 返回数据示例 ``` { "code": 0, "message": "成功", "data": { "list": [ { "store_id": 2, "store_name": "演示店铺", "cate_id": 1, "cate_name": "服装", "store_logo": "http://www.xxx.com/data/files/store_2/logo.jpg", "credit_image": "http://www.xxx.com/data/files/store_2/credit.jpg", "credit_value": 1, "praise_rate": 66.67, "stype": "company", "sgrade": 1, "goods_count": 100, "collects": 89, "region_id": 477, "province": "广西壮族自治区", "city": "南宁", "district": "青秀区", "address": "枫林路890号", "tel": "", "im_qq": "", "add_time": "2020-1-9 15:40:49" } ], "pagination": { "page":1, "page_size":10, "page_count":1, "total":1 } } } ```