2689ecca8e
Some checks are pending
Actions / Litemall-all (11) (push) Waiting to run
Actions / Litemall-all (11.0.3) (push) Waiting to run
Actions / Litemall-all (8) (push) Waiting to run
Actions / Litemall-all (8.0.192) (push) Waiting to run
Actions / Litemall-admin (10.x) (push) Waiting to run
Actions / Litemall-admin (12.x) (push) Waiting to run
Actions / Litemall-admin (14.x) (push) Waiting to run
Actions / Litemall-vue (10.x) (push) Waiting to run
Actions / Litemall-vue (12.x) (push) Waiting to run
Actions / Litemall-vue (14.x) (push) Waiting to run
3406 lines
86 KiB
Markdown
3406 lines
86 KiB
Markdown
# 前后端接口文档
|
||
|
||
本项目前后端接口规范和接口文档。
|
||
|
||
注意：
|
||
> 1. 以下API部分基于nideshop开源项目的API设计；
|
||
> 2. 以下API是参考API，可能不是很合理，欢迎开发者交流。
|
||
> 3. 接口文档处于开发中，如果发现接口描述和接口实际不对应，欢迎PR或者报告。
|
||
|
||
## 1 前后端接口规范
|
||
|
||
### 1.1 请求格式
|
||
|
||
这里没有采用RESTful风格的接口，而是定义具体语义的接口。
|
||
目前只使用`GET`和`POST`来表示请求内容和更新内容两种语义。
|
||
|
||
#### 1.1.1 GET请求
|
||
|
||
GET API_URL?params
|
||
|
||
例如
|
||
|
||
GET /home/index
|
||
|
||
或者
|
||
|
||
GET /goods/list?page=1&limit=10
|
||
|
||
#### 1.1.2 POST更新
|
||
|
||
POST API_URL
|
||
{
|
||
body
|
||
}
|
||
|
||
例如
|
||
|
||
POST /cart/clear
|
||
|
||
或者
|
||
|
||
POST /goods/star
|
||
{
|
||
id: 1
|
||
}
|
||
|
||
#### 1.1.3 分页请求参数
|
||
|
||
当GET请求后端获取数组数据时，需要传递分页参数。
|
||
|
||
例如
|
||
|
||
GET /goods/list?page=1&limit=10&sort=add_time&order=desc
|
||
|
||
本项目的通用分页请求参数统一传递四个：
|
||
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
* page, 和通常计算机概念中数组下标从0开始不同，这里的page参数应该从1开始，1即代表第一页数据;
|
||
* limit, 分页大小；
|
||
* sort, 例如"add_time"或者"id";
|
||
* order, 只能是"desc"或者"asc"。
|
||
|
||
此外，这里四个参数是可选的，后端应该设置默认参数，因此即使前端不设置，
|
||
后端也会自动返回合适的对象数组响应数据。
|
||
|
||
注意:
|
||
> 这里的参数是需要后端支持的，在一些场景下，例如数组对象是组装而成，
|
||
> 有可能sort和order不支持。
|
||
|
||
讨论：
|
||
> 有些请求后端是所有数据，这里page和limit可能设置是无意义的。但是
|
||
> 仍然建议加上两个参数，例如page=1, limit=1000。
|
||
|
||
也就是说，请求后端数组数据时，同一传递四个分页参数，可能是比较良好的做法。
|
||
|
||
### 1.2 响应格式
|
||
|
||
Content-Type: application/json;charset=UTF-8
|
||
|
||
{
|
||
body
|
||
}
|
||
|
||
|
||
而body是存在一定格式的json内容：
|
||
|
||
{
|
||
errno: xxx,
|
||
errmsg: xxx,
|
||
data: {}
|
||
}
|
||
|
||
#### 1.2.1 失败异常
|
||
|
||
{
|
||
errno: xxx,
|
||
errmsg: xxx
|
||
}
|
||
|
||
* errno是错误码，具体语义见1.3节。
|
||
* errmsg是错误信息。
|
||
|
||
#### 1.2.2 操作成功
|
||
|
||
{
|
||
errno: 0,
|
||
errmsg: "成功",
|
||
}
|
||
|
||
#### 1.2.3 普通对象
|
||
|
||
{
|
||
errno: 0,
|
||
errmsg: "成功",
|
||
data: {}
|
||
}
|
||
|
||
#### 1.2.4 数组对象
|
||
|
||
{
|
||
errno: 0,
|
||
errmsg: "成功",
|
||
data: {
|
||
list: [],
|
||
total: XX，
|
||
page: XX,
|
||
limit: XX,
|
||
pages: XX
|
||
}
|
||
}
|
||
|
||
list是对象数组，total是总的数量。
|
||
|
||
### 1.3 错误码
|
||
|
||
#### 1.3.1 系统通用错误码
|
||
|
||
系统通用错误码包括4XX和5XX
|
||
|
||
* 4xx，前端错误，说明前端开发者需要重新了解后端接口使用规范：
|
||
* 401，参数错误，即前端没有传递后端需要的参数；
|
||
* 402，参数值错误，即前端传递的参数值不符合后端接收范围。
|
||
|
||
* 5xx，后端系统错误，除501外，说明后端开发者应该继续优化代码，尽量避免返回后端系统错误码：
|
||
* 501，验证失败，即后端要求用户登录；
|
||
* 502，系统内部错误，即没有合适命名的后端内部错误；
|
||
* 503，业务不支持，即后端虽然定义了接口，但是还没有实现功能；
|
||
* 504，更新数据失效，即后端采用了乐观锁更新，而并发更新时存在数据更新失效；
|
||
* 505，更新数据失败，即后端数据库更新失败（正常情况应该更新成功）。
|
||
|
||
#### 1.3.2 商场业务错误码
|
||
|
||
* AUTH_INVALID_ACCOUNT = 700
|
||
* AUTH_CAPTCHA_UNSUPPORT = 701
|
||
* AUTH_CAPTCHA_FREQUENCY = 702
|
||
* AUTH_CAPTCHA_UNMATCH = 703
|
||
* AUTH_NAME_REGISTERED = 704
|
||
* AUTH_MOBILE_REGISTERED = 705
|
||
* AUTH_MOBILE_UNREGISTERED = 706
|
||
* AUTH_INVALID_MOBILE = 707
|
||
* AUTH_OPENID_UNACCESS = 708
|
||
* AUTH_OPENID_BINDED = 709
|
||
* GOODS_UNSHELVE = 710
|
||
* GOODS_NO_STOCK = 711
|
||
* GOODS_UNKNOWN = 712
|
||
* GOODS_INVALID = 713
|
||
* ORDER_UNKNOWN = 720
|
||
* ORDER_INVALID = 721
|
||
* ORDER_CHECKOUT_FAIL = 722
|
||
* ORDER_CANCEL_FAIL = 723
|
||
* ORDER_PAY_FAIL = 724
|
||
* ORDER_INVALID_OPERATION = 725
|
||
* ORDER_COMMENTED = 726
|
||
* ORDER_COMMENT_EXPIRED = 727
|
||
* GROUPON_EXPIRED = 730
|
||
* COUPON_EXCEED_LIMIT = 740
|
||
* COUPON_RECEIVE_FAIL= 741
|
||
* COUPON_CODE_INVALID= 742
|
||
|
||
#### 1.3.3 管理后台业务错误码
|
||
|
||
* ADMIN_INVALID_NAME = 601
|
||
* ADMIN_INVALID_PASSWORD = 602
|
||
* ADMIN_NAME_EXIST = 602
|
||
* ADMIN_ALTER_NOT_ALLOWED = 603
|
||
* ADMIN_DELETE_NOT_ALLOWED = 604
|
||
* ADMIN_INVALID_ACCOUNT = 605
|
||
* GOODS_UPDATE_NOT_ALLOWED = 610
|
||
* GOODS_NAME_EXIST = 611
|
||
* ORDER_CONFIRM_NOT_ALLOWED = 620
|
||
* ORDER_REFUND_FAILED = 621
|
||
* ORDER_REPLY_EXIST = 622
|
||
* USER_INVALID_NAME = 630
|
||
* USER_INVALID_PASSWORD = 631
|
||
* USER_INVALID_MOBILE = 632
|
||
* USER_NAME_EXIST = 633
|
||
* USER_MOBILE_EXIST = 634
|
||
* ROLE_NAME_EXIST = 640
|
||
* ROLE_SUPER_SUPERMISSION = 641
|
||
* ROLE_USER_EXIST = 642
|
||
|
||
### 1.4 Token
|
||
|
||
前后端采用token来验证访问权限。
|
||
|
||
#### 1.4.1 Header&Token
|
||
|
||
前后端Token交换流程如下：
|
||
|
||
1. 前端访问商场登录API或者管理后台登录API;
|
||
|
||
2. 成功以后，前端会接收后端响应的一个token，保存在本地；
|
||
|
||
3. 请求受保护API则，则采用自定义头部携带此token
|
||
|
||
4. 后端检验Token，成功则返回受保护的数据。
|
||
|
||
#### 1.4.2 商场自定义Header
|
||
|
||
访问受保护商场API采用自定义`X-Litemall-Token`头部
|
||
|
||
1. 小商城（或轻商场）前端访问小商城后端登录API`/wx/auth/login`
|
||
|
||
POST /wx/auth/login
|
||
|
||
{
|
||
"username": "user123",
|
||
"password": "user123"
|
||
}
|
||
|
||
2. 成功以后，前端会接收后端响应的一个token，
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"userInfo": {
|
||
"nickName": "user123",
|
||
"avatarUrl": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ0aGlzIGlzIGxpdGVtYWxsIHRva2VuIiwiYXVkIjoiTUlOSUFQUCIsImlzcyI6IkxJVEVNQUxMIiwiZXhwIjoxNTU3MzI2ODUwLCJ1c2VySWQiOjEsImlhdCI6MTU1NzMxOTY1MH0.XP0TuhupV_ttQsCr1KTaPZVlTbVzVOcnq_K0kXdbri0"
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
3. 请求受保护API则，则采用自定义头部携带此token
|
||
|
||
GET http://localhost:8080/wx/address/list
|
||
X-Litemall-Token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ0aGlzIGlzIGxpdGVtYWxsIHRva2VuIiwiYXVkIjoiTUlOSUFQUCIsImlzcyI6IkxJVEVNQUxMIiwiZXhwIjoxNTU3MzM2ODU0LCJ1c2VySWQiOjIsImlhdCI6MTU1NzMyOTY1NH0.JY1-cqOnmi-CVjFohZMqK2iAdAH4O6CKj0Cqd5tMF3M
|
||
|
||
#### 1.4.3 管理后台自定义Header
|
||
|
||
访问受保护管理后台API则是自定义`X-Litemall-Admin-Token`头部。
|
||
|
||
1. 管理后台前端访问管理后台后端登录API`/admin/auth/login`
|
||
|
||
POST /admin/auth/login
|
||
|
||
{
|
||
"username": "admin123",
|
||
"password": "admin123"
|
||
}
|
||
|
||
2. 成功以后，管理后台前端会接收后端响应的一个token，
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"adminInfo": {
|
||
"nickName": "admin123",
|
||
"avatar": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"token": "f2dbcae8-6e25-4f8e-bc58-aa81d512c952"
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
3. 请求受保护API时，则采用自定义头部携带此token
|
||
|
||
GET http://localhost:8080/wx/address/list
|
||
X-Litemall-Admin-Token: f2dbcae8-6e25-4f8e-bc58-aa81d512c952
|
||
|
||
### 1.5 版本控制
|
||
|
||
API应该存在版本控制，以保证兼容性。
|
||
|
||
由于仍处于开发中，因此目前未引入版本控制。
|
||
|
||
### 1.6 API格式
|
||
|
||
这里定义一个API的格式：
|
||
|
||
应用场景
|
||
|
||
xxx
|
||
|
||
接口链接
|
||
|
||
xxx
|
||
|
||
请求参数
|
||
|
||
xxx
|
||
|
||
响应内容
|
||
|
||
xxx
|
||
|
||
错误码
|
||
|
||
xxx
|
||
|
||
### 1.7 API预览
|
||
|
||
接下来会分别从用户层面和管理员层面构建商场API服务和管理后台API服务。
|
||
|
||
商场API服务涉及
|
||
|
||
* 安全服务
|
||
* 首页服务
|
||
* 类目服务
|
||
* 商品服务
|
||
* 购物车服务
|
||
* 订单服务
|
||
* 会员服务
|
||
* 收货地址服务
|
||
* 品牌商服务
|
||
* 收藏服务
|
||
* 评论服务
|
||
* 优惠券服务
|
||
* 反馈服务
|
||
* 足迹服务
|
||
* 团购服务
|
||
* 帮助服务
|
||
* 搜索服务
|
||
* 专题服务
|
||
* 对象存储服务
|
||
|
||
|
||
管理后台API服务涉及:
|
||
* 略
|
||
|
||
### 1.8 API测试
|
||
|
||
本节以GET、POST两种方式以及是否需要登录举例说明如何测试和使用本项目API。
|
||
|
||
开发者可以使用各种API测试命令或者工具，这里以Postman作为工具。
|
||
|
||
#### 1.8.1 GET 示例
|
||
|
||
如果一个API是GET方法，那么请求参数需要在访问链接后面：
|
||
|
||
例如测试2.4.2节商品详情API
|
||
|
||
|
||
|
||
#### 1.8.2 GET & Token 示例
|
||
|
||
如果需要登录才能访问数据，则需要先向后端请求登录，得到token，然后请求时携带token。
|
||
|
||
例如测试2.8.1节收货地址列表API
|
||
|
||
如果没有登录，则返回未登录信息
|
||
|
||
|
||
|
||
因此测试这些API，需要先登录
|
||
|
||
|
||
|
||
然后，采用自定义`X-Litemall-Token`来携带token访问商场API
|
||
|
||
|
||
|
||
注意：
|
||
> 访问受保护商场API是采用自定义`X-Litemall-Token`头部；
|
||
> 而访问受保护管理后台API则是自定义`X-Litemall-Admin-Token`头部。
|
||
|
||
#### 1.8.3 POST 示例
|
||
|
||
通常POST请求后端时，都需要先登录才能有权限上传数据，因此这里不举例说明。
|
||
|
||
#### 1.8.4 POST & Token 示例
|
||
|
||
如果需要登录才能提交数据，则需要先向后端请求登录，得到token，然后请求时携带token。
|
||
|
||
|
||
|
||
因此测试这些API，需要先登录
|
||
|
||
|
||
|
||
然后，采用自定义`X-Litemall-Token`来携带token访问商场API
|
||
|
||
|
||
|
||
注意：
|
||
> 访问受保护商场API是采用自定义`X-Litemall-Token`头部；
|
||
> 而访问受保护管理后台API则是自定义`X-Litemall-Admin-Token`头部。
|
||
|
||
### 1.9 API保护
|
||
|
||
为了保护API不被滥用，通常API需要引入保护机制，例如OAuth2。
|
||
|
||
本项目暂时无保护机制，因此实际上一旦开发者知道服务器，就很容易访问API。
|
||
|
||
### 1.10 API局限性
|
||
|
||
当前API还存在一些问题，后面需要继续优化和完善。
|
||
|
||
* 无意义的通用字段
|
||
|
||
* 团购API完善
|
||
|
||
### 1.11 Not Like Swagger
|
||
|
||
本项目不是很接受Swagger，基于以下考虑：
|
||
|
||
* 前后端中立
|
||
|
||
在前后端分离项目中，依赖后端的Swagger来生成项目API似乎不是很理想，
|
||
这实际上把项目API设计工作过多地压在后端，同时前端也被迫依赖后端，
|
||
因为后端如果没有写好文档注解，前端不可能了解API的输入输出。
|
||
|
||
可能一种合理的做法应该这样：
|
||
项目初期前后端一起完成一个完整基本的API文档，定义好交互规范和具体API的行为，然后双方同时开始开发工作；
|
||
某个开发阶段，前端需要更多的数据或者新的API支持，此时也不需要立即联系后端（除非API产生破坏性变更），
|
||
而是暂时基于mock和自定义mock数据独立开发；之后，在合适阶段（可以按照项目规定，例如三天或者周五），
|
||
前后端再次沟通API的变更，后端了解需求后则可以接受、拒绝或者调整，当然变更必须要在API文档中体现和更新；
|
||
下一个开发阶段，前端和后端能够再次基于最新的API文档来调整自己代码。
|
||
最后项目测试时，只要前端对照API文档，后端也是对照API文档。
|
||
|
||
* 后端代码简洁
|
||
|
||
如果使用Swagger，为了得到完整的文档，需要在每一个方法前面加上多个文档注解，文档越是详尽，则注解越多，
|
||
造成代码不是很简洁。特别是具备代码属性的注解和Swagger文档注解混杂在一起，可能不是很好。
|
||
|
||
当然，本项目也简单地配置了Swagger(见`WxSwagger2Configuration`和`AdminSwagger2Configuration`)，
|
||
* 在线Swagger文档链接：http://122.51.199.160:8080/swagger-ui.html
|
||
* 本地Swagger文档链接：http://localhost:8080/swagger-ui.html
|
||
|
||
此外，也使用了swagger-bootstrap-ui对Swagger进一步增强了使用效果。
|
||
* 在线swagger-bootstrap-ui文档链接：http://122.51.199.160:8080/doc.html
|
||
* 本地swagger-bootstrap-ui文档链接：http://localhost:8080/doc.html
|
||
|
||
当然正如上文讨论，本项目不是很接受Swagger的理念，所以后端没有使用Swagger的相关文档注解，
|
||
这也导致了Swagger接口文档的不具可读性。如果开发者需要，可以自行在后端补充Swagger注解。
|
||
|
||
需要注意的是：
|
||
> 这里接口默认是公开的，因此项目一旦需要上线，请及时删除swagger和swagger-bootstrap-ui依赖和配置，
|
||
> 或者采取其他手段，防止接口对外暴露造成**安全隐患**。
|
||
|
||
例如
|
||
```
|
||
swagger:
|
||
production: false
|
||
```
|
||
|
||
## 2 商城API服务
|
||
|
||
### 2.1 安全服务
|
||
|
||
#### 2.1.1 小程序微信登录
|
||
|
||
应用场景
|
||
|
||
小程序环境下微信登录。
|
||
|
||
接口链接
|
||
|
||
xxx
|
||
|
||
请求参数
|
||
|
||
xxx
|
||
|
||
响应内容
|
||
|
||
xxx
|
||
|
||
错误码
|
||
|
||
xxx
|
||
|
||
#### 2.1.2 账号登录
|
||
|
||
应用场景
|
||
|
||
基于用户名和密码的账号登录
|
||
|
||
接口链接
|
||
|
||
POST /wx/auth/login
|
||
|
||
请求参数
|
||
|
||
{
|
||
"username": "user123",
|
||
"password": "user123"
|
||
}
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"userInfo": {
|
||
"nickName": "user123",
|
||
"avatarUrl": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"token": "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiJ0aGlzIGlzIGxpdGVtYWxsIHRva2VuIiwiYXVkIjoiTUlOSUFQUCIsImlzcyI6IkxJVEVNQUxMIiwiZXhwIjoxNTU3MzI2ODUwLCJ1c2VySWQiOjEsImlhdCI6MTU1NzMxOTY1MH0.XP0TuhupV_ttQsCr1KTaPZVlTbVzVOcnq_K0kXdbri0"
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.1.3 注册
|
||
|
||
应用场景
|
||
|
||
xxx
|
||
|
||
接口链接
|
||
|
||
xxx
|
||
|
||
请求参数
|
||
|
||
xxx
|
||
|
||
响应内容
|
||
|
||
xxx
|
||
|
||
错误码
|
||
|
||
xxx
|
||
|
||
#### 2.1.4 退出
|
||
|
||
应用场景
|
||
|
||
账号退出
|
||
|
||
接口链接
|
||
|
||
POST /wx/auth/logout
|
||
|
||
请求参数
|
||
|
||
{
|
||
"username": "user123",
|
||
"password": "user123"
|
||
}
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.1.5 注册验证码
|
||
|
||
应用场景
|
||
|
||
用户未登录情况下，请求后端发送注册验证码用于注册。
|
||
|
||
接口链接
|
||
|
||
xxx
|
||
|
||
请求参数
|
||
|
||
xxx
|
||
|
||
响应内容
|
||
|
||
xxx
|
||
|
||
错误码
|
||
|
||
xxx
|
||
|
||
#### 2.1.6 操作验证码
|
||
|
||
应用场景
|
||
|
||
用户已登录情况下，请求后端发送操作验证码用于相关操作。
|
||
|
||
接口链接
|
||
|
||
xxx
|
||
|
||
请求参数
|
||
|
||
xxx
|
||
|
||
响应内容
|
||
|
||
xxx
|
||
|
||
错误码
|
||
|
||
xxx
|
||
|
||
#### 2.1.7 账号密码修改
|
||
|
||
应用场景
|
||
|
||
账号密码修改
|
||
|
||
接口链接
|
||
|
||
xxx
|
||
|
||
请求参数
|
||
|
||
xxx
|
||
|
||
响应内容
|
||
|
||
xxx
|
||
|
||
错误码
|
||
|
||
xxx
|
||
|
||
#### 2.1.8 微信手机号码绑定
|
||
|
||
应用场景
|
||
|
||
微信手机号码绑定，仅用于小程序环境。
|
||
|
||
接口链接
|
||
|
||
xxx
|
||
|
||
请求参数
|
||
|
||
xxx
|
||
|
||
响应内容
|
||
|
||
xxx
|
||
|
||
错误码
|
||
|
||
xxx
|
||
|
||
#### 2.1.9 手机号码修改
|
||
|
||
应用场景
|
||
|
||
手机号码修改
|
||
|
||
接口链接
|
||
|
||
xxx
|
||
|
||
请求参数
|
||
|
||
xxx
|
||
|
||
响应内容
|
||
|
||
xxx
|
||
|
||
错误码
|
||
|
||
xxx
|
||
|
||
#### 2.1.10 账号信息
|
||
|
||
应用场景
|
||
|
||
账号信息
|
||
|
||
接口链接
|
||
|
||
GET /wx/auth/info
|
||
|
||
请求参数
|
||
|
||
无
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"gender": 1,
|
||
"nickName": "user123",
|
||
"mobile": "",
|
||
"avatar": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.1.11 账号信息更新
|
||
|
||
应用场景
|
||
|
||
账号信息更新。
|
||
|
||
接口链接
|
||
|
||
POST /wx/auth/profile
|
||
|
||
请求参数
|
||
|
||
{
|
||
"gender": 1,
|
||
"nickName": "user123",
|
||
"avatar": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
}
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.2 首页服务
|
||
|
||
#### 2.2.1 首页数据
|
||
|
||
应用场景
|
||
|
||
首页数据
|
||
|
||
接口链接
|
||
|
||
GET /wx/home/index
|
||
|
||
请求参数
|
||
|
||
无
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"newGoodsList": [
|
||
{
|
||
"id": 1181000,
|
||
"name": "母亲节礼物-舒适安睡组合",
|
||
"brief": "安心舒适是最好的礼物",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/1f67b1970ee20fd572b7202da0ff705d.png",
|
||
"isNew": true,
|
||
"isHot": false,
|
||
"counterPrice": 2618.00,
|
||
"retailPrice": 2598.00
|
||
},
|
||
{
|
||
"id": 1116011,
|
||
"name": "蔓越莓曲奇 200克",
|
||
"brief": "酥脆奶香，甜酸回味",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/767b370d07f3973500db54900bcbd2a7.png",
|
||
"isNew": true,
|
||
"isHot": true,
|
||
"counterPrice": 56.00,
|
||
"retailPrice": 36.00
|
||
},
|
||
{
|
||
"id": 1127047,
|
||
"name": "趣味粉彩系列笔记本",
|
||
"brief": "粉彩色泽，记录生活",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/6c03ca93d8fe404faa266ea86f3f1e43.png",
|
||
"isNew": true,
|
||
"isHot": false,
|
||
"counterPrice": 49.00,
|
||
"retailPrice": 29.00
|
||
},
|
||
{
|
||
"id": 1135002,
|
||
"name": "宫廷奢华真丝四件套",
|
||
"brief": "100%桑蚕丝，丝滑润肤",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/45548f26cfd0c7c41e0afc3709d48286.png",
|
||
"isNew": true,
|
||
"isHot": false,
|
||
"counterPrice": 2619.00,
|
||
"retailPrice": 2599.00
|
||
},
|
||
{
|
||
"id": 1152161,
|
||
"name": "竹语丝麻印花四件套",
|
||
"brief": "3重透气，清爽柔滑",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/977401e75113f7c8334c4fb5b4bf6215.png",
|
||
"isNew": true,
|
||
"isHot": false,
|
||
"counterPrice": 479.00,
|
||
"retailPrice": 459.00
|
||
},
|
||
{
|
||
"id": 1166008,
|
||
"name": "Carat钻石 不粘厨具组合",
|
||
"brief": "钻石涂层，不粘锅锅具组",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/615a16e899e01efb780c488df4233f48.png",
|
||
"isNew": true,
|
||
"isHot": false,
|
||
"counterPrice": 479.00,
|
||
"retailPrice": 459.00
|
||
}
|
||
],
|
||
"couponList": [
|
||
{
|
||
"id": 2,
|
||
"name": "限时满减券",
|
||
"desc": "全场通用",
|
||
"tag": "无限制",
|
||
"discount": 10.00,
|
||
"min": 99.00,
|
||
"days": 10
|
||
}
|
||
],
|
||
"channel": [
|
||
{
|
||
"id": 1005000,
|
||
"name": "居家",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/a45c2c262a476fea0b9fc684fed91ef5.png"
|
||
},
|
||
{
|
||
"id": 1005001,
|
||
"name": "餐厨",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/ad8b00d084cb7d0958998edb5fee9c0a.png"
|
||
},
|
||
{
|
||
"id": 1005002,
|
||
"name": "饮食",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/c9280327a3fd2374c000f6bf52dff6eb.png"
|
||
},
|
||
{
|
||
"id": 1008000,
|
||
"name": "配件",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/11abb11c4cfdee59abfb6d16caca4c6a.png"
|
||
},
|
||
{
|
||
"id": 1010000,
|
||
"name": "服装",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/28a685c96f91584e7e4876f1397767db.png"
|
||
},
|
||
{
|
||
"id": 1011000,
|
||
"name": "婴童",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/1ba9967b8de1ac50fad21774a4494f5d.png"
|
||
},
|
||
{
|
||
"id": 1012000,
|
||
"name": "杂货",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/c2a3d6349e72c35931fe3b5bcd0966be.png"
|
||
},
|
||
{
|
||
"id": 1013001,
|
||
"name": "洗护",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/9fe068776b6b1fca13053d68e9c0a83f.png"
|
||
},
|
||
{
|
||
"id": 1019000,
|
||
"name": "志趣",
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/7093cfecb9dde1dd3eaf459623df4071.png"
|
||
}
|
||
],
|
||
"grouponList": [
|
||
{
|
||
"id": 1109008,
|
||
"name": "云端沙发组合",
|
||
"brief": "MUJI供应商携手打造",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c5be2604c0e4186a4e7079feeb742cee.png",
|
||
"counterPrice": 4019.00,
|
||
"retailPrice": 3999.00,
|
||
"grouponPrice": 3949.00,
|
||
"grouponDiscount": 50,
|
||
"grouponMember": 5
|
||
},
|
||
{
|
||
"id": 1039051,
|
||
"name": "多功能午睡枕",
|
||
"brief": "放松自在的午后时光",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c8ca0600fa7ba11ca8be6a3173dd38c9.png",
|
||
"counterPrice": 99.00,
|
||
"retailPrice": 79.00,
|
||
"grouponPrice": 59.00,
|
||
"grouponDiscount": 20,
|
||
"grouponMember": 20
|
||
}
|
||
],
|
||
"banner": [
|
||
{
|
||
"id": 1,
|
||
"name": "合作 谁是你的菜",
|
||
"link": "",
|
||
"url": "http://yanxuan.nosdn.127.net/65091eebc48899298171c2eb6696fe27.jpg",
|
||
"position": 1,
|
||
"content": "合作 谁是你的菜",
|
||
"enabled": true,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 2,
|
||
"name": "活动 美食节",
|
||
"link": "",
|
||
"url": "http://yanxuan.nosdn.127.net/bff2e49136fcef1fd829f5036e07f116.jpg",
|
||
"position": 1,
|
||
"content": "活动 美食节",
|
||
"enabled": true,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 3,
|
||
"name": "活动 母亲节",
|
||
"link": "",
|
||
"url": "http://yanxuan.nosdn.127.net/8e50c65fda145e6dd1bf4fb7ee0fcecc.jpg",
|
||
"position": 1,
|
||
"content": "活动 母亲节5",
|
||
"enabled": true,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
}
|
||
],
|
||
"brandList": [
|
||
{
|
||
"id": 1001000,
|
||
"name": "MUJI制造商",
|
||
"desc": "严选精选了MUJI制造商和生产原料，\n用几乎零利润的价格，剔除品牌溢价，\n让用户享受原品牌的品质生活。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/1541445967645114dd75f6b0edc4762d.png",
|
||
"floorPrice": 12.90
|
||
},
|
||
{
|
||
"id": 1001002,
|
||
"name": "内野制造商",
|
||
"desc": "严选从世界各地挑选毛巾，最终选择了为日本内野代工的工厂，追求毛巾的柔软度与功能性。品质比肩商场几百元的毛巾。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/8ca3ce091504f8aa1fba3fdbb7a6e351.png",
|
||
"floorPrice": 29.00
|
||
},
|
||
{
|
||
"id": 1001003,
|
||
"name": "Adidas制造商",
|
||
"desc": "严选找到为Adidas等品牌制造商，\n选取优质原材料，与厂方一起设计，\n为你提供好的理想的运动装备。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/335334d0deaff6dc3376334822ab3a2f.png",
|
||
"floorPrice": 49.00
|
||
},
|
||
{
|
||
"id": 1001007,
|
||
"name": "优衣库制造商",
|
||
"desc": "严选找到日本知名服装UNIQLO的制造商，\n选取优质长绒棉和精梳工艺，\n与厂方一起设计，为你提供理想的棉袜。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/0d72832e37e7e3ea391b519abbbc95a3.png",
|
||
"floorPrice": 29.00
|
||
}
|
||
],
|
||
"hotGoodsList": [
|
||
{
|
||
"id": 1152008,
|
||
"name": "魔兽世界 部落 护腕 一只",
|
||
"brief": "吸汗、舒适、弹性、防护、耐用",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/203cb83d93606865e3ddde57b69b9e9a.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 49.00,
|
||
"retailPrice": 29.00
|
||
},
|
||
{
|
||
"id": 1152009,
|
||
"name": "魔兽世界 联盟 护腕 一只",
|
||
"brief": "吸汗、舒适、弹性、防护、耐用",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/ae6d41117717387b82dcaf1dfce0cd97.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 49.00,
|
||
"retailPrice": 29.00
|
||
},
|
||
{
|
||
"id": 1152031,
|
||
"name": "魔兽世界-伊利丹颈枕眼罩套装",
|
||
"brief": "差旅好伴侣",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/fd6e78a397bd9e9804116a36f0270b0a.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 119.00,
|
||
"retailPrice": 99.00
|
||
},
|
||
{
|
||
"id": 1022000,
|
||
"name": "意式毛线绣球四件套",
|
||
"brief": "浪漫毛线绣球，简约而不简单",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/5350e35e6f22165f38928f3c2c52ac57.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 319.00,
|
||
"retailPrice": 299.00
|
||
},
|
||
{
|
||
"id": 1011004,
|
||
"name": "色织精梳AB纱格纹空调被",
|
||
"brief": "加大加厚，双色精彩",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/0984c9388a2c3fd2335779da904be393.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 219.00,
|
||
"retailPrice": 199.00
|
||
},
|
||
{
|
||
"id": 1084003,
|
||
"name": "纯棉美式绞花针织盖毯",
|
||
"brief": "美式提花，温暖舒适",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/cf40c167e7054fe184d49f19121f63c7.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 219.00,
|
||
"retailPrice": 199.00
|
||
}
|
||
],
|
||
"topicList": [
|
||
{
|
||
"id": 264,
|
||
"title": "设计师们推荐的应季好物",
|
||
"subtitle": "原创设计春款系列上新",
|
||
"price": 29.90,
|
||
"readCount": "77.7k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14918201901050274.jpg"
|
||
},
|
||
{
|
||
"id": 266,
|
||
"title": "一条丝巾就能提升时髦度",
|
||
"subtitle": "不知道大家对去年G20时，严选与国礼制造商一起推出的《凤凰于飞》等几款丝巾是否还...",
|
||
"price": 0.00,
|
||
"readCount": "35.0k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14919007135160213.jpg"
|
||
},
|
||
{
|
||
"id": 268,
|
||
"title": "米饭好吃的秘诀：会呼吸的锅",
|
||
"subtitle": "今年1月份，我们联系到了日本伊贺地区的长谷园，那里有着180年伊贺烧历史的窑厂。...",
|
||
"price": 0.00,
|
||
"readCount": "33.3k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14920623353130483.jpg"
|
||
},
|
||
{
|
||
"id": 271,
|
||
"title": "选式新懒人",
|
||
"subtitle": "懒出格调，懒出好生活。",
|
||
"price": 15.00,
|
||
"readCount": "57.7k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14924199099661697.jpg"
|
||
}
|
||
],
|
||
"floorGoodsList": [
|
||
{
|
||
"name": "居家",
|
||
"goodsList": [
|
||
{
|
||
"id": 1110016,
|
||
"name": "天然硅胶宠物除毛按摩刷",
|
||
"brief": "顺滑平面，猫狗通用，去除死毛",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/3bd73b7279a83d1cbb50c0e45778e6d6.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 59.00,
|
||
"retailPrice": 39.00
|
||
},
|
||
{
|
||
"id": 1110017,
|
||
"name": "耐用材料猫咪护理清洁套装",
|
||
"brief": "精致钢材，美容清洁",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/534231583f82572398ec84bad425cdaf.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 99.00,
|
||
"retailPrice": 79.00
|
||
},
|
||
{
|
||
"id": 1110018,
|
||
"name": "耐用狗狗清洁美容护理套装",
|
||
"brief": "精致钢材，耐咬美容",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/d93aa5d6e7a296101cf4cb72613aeda6.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 99.00,
|
||
"retailPrice": 79.00
|
||
},
|
||
{
|
||
"id": 1110019,
|
||
"name": "宠物合金钢安全除菌指甲护理组合",
|
||
"brief": "猫狗皆可用，保护家具",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/1e7e392b6fc9da99dc112197b7444eec.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 89.00,
|
||
"retailPrice": 69.00
|
||
}
|
||
],
|
||
"id": 1005000
|
||
},
|
||
{
|
||
"name": "餐厨",
|
||
"goodsList": [
|
||
{
|
||
"id": 1023003,
|
||
"name": "100年传世珐琅锅 全家系列",
|
||
"brief": "特质铸铁，大容量全家共享",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c39d54c06a71b4b61b6092a0d31f2335.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 418.00,
|
||
"retailPrice": 398.00
|
||
},
|
||
{
|
||
"id": 1073008,
|
||
"name": "铸铁珐琅牛排煎锅",
|
||
"brief": "沥油隔水，煎出外焦里嫩",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/619e46411ccd62e5c0f16692ee1a85a0.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 169.00,
|
||
"retailPrice": 149.00
|
||
},
|
||
{
|
||
"id": 1051000,
|
||
"name": "Carat钻石炒锅30cm",
|
||
"brief": "安全涂层，轻便无烟",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/e564410546a11ddceb5a82bfce8da43d.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 200.00,
|
||
"retailPrice": 180.00
|
||
},
|
||
{
|
||
"id": 1051001,
|
||
"name": "Carat钻石煎锅28cm",
|
||
"brief": "耐磨涂层，导热迅速",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/f53ed57d9e23fda7e24dfd0e0a50c5d1.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 179.00,
|
||
"retailPrice": 159.00
|
||
}
|
||
],
|
||
"id": 1005001
|
||
},
|
||
{
|
||
"name": "饮食",
|
||
"goodsList": [
|
||
{
|
||
"id": 1045000,
|
||
"name": "绿茶蛋黄酥 200克/4枚入",
|
||
"brief": "香甜茶食，果腹优选",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/b2adc3fd9b84a289a1be03e8ee400e61.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 48.00,
|
||
"retailPrice": 28.00
|
||
},
|
||
{
|
||
"id": 1116011,
|
||
"name": "蔓越莓曲奇 200克",
|
||
"brief": "酥脆奶香，甜酸回味",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/767b370d07f3973500db54900bcbd2a7.png",
|
||
"isNew": true,
|
||
"isHot": true,
|
||
"counterPrice": 56.00,
|
||
"retailPrice": 36.00
|
||
},
|
||
{
|
||
"id": 1070000,
|
||
"name": "星云酥 180克/3颗",
|
||
"brief": "酥饼界的小仙女",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/8392725765cdd57fdae3f173877f4bda.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 46.00,
|
||
"retailPrice": 26.00
|
||
},
|
||
{
|
||
"id": 1155015,
|
||
"name": "绿豆糕 80克（4枚入）",
|
||
"brief": "细腻松软，入口绵柔",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/66b9f1638c0517d179262f14ed1345f9.png",
|
||
"isNew": true,
|
||
"isHot": false,
|
||
"counterPrice": 32.90,
|
||
"retailPrice": 12.90
|
||
}
|
||
],
|
||
"id": 1005002
|
||
},
|
||
{
|
||
"name": "配件",
|
||
"goodsList": [
|
||
{
|
||
"id": 1085019,
|
||
"name": "20寸 纯PC“铝框”（非全铝）登机箱",
|
||
"brief": "铝质包角，牢固抗摔",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/65c955a7a98e84d44ca30bb88a591eac.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 369.00,
|
||
"retailPrice": 349.00
|
||
},
|
||
{
|
||
"id": 1086052,
|
||
"name": "20寸 铝镁合金登机箱",
|
||
"brief": "时尚金属箱，奢品质感",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/93171a281c4ed272c007a050816e6f6c.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 879.00,
|
||
"retailPrice": 859.00
|
||
},
|
||
{
|
||
"id": 1152101,
|
||
"name": "魔兽世界 部落 奥格瑞玛 拉杆箱 可登机",
|
||
"brief": "18寸，可携带登机",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c1c62211a17b71a634fa0c705d11fb42.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 908.00,
|
||
"retailPrice": 888.00
|
||
},
|
||
{
|
||
"id": 1114011,
|
||
"name": "104升 纯PC拉链斜纹拉杆箱",
|
||
"brief": "104升的体积，90升的价格",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/196b5ce11930b4eadaec563cb0406634.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 319.00,
|
||
"retailPrice": 299.00
|
||
}
|
||
],
|
||
"id": 1008000
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
无
|
||
|
||
### 2.3 类目服务
|
||
|
||
### 2.4 商品服务
|
||
|
||
#### 2.4.1 商品列表
|
||
|
||
应用场景
|
||
|
||
商品列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/goods/list
|
||
|
||
请求参数
|
||
|
||
isNew: 是否新品，true或者false
|
||
isHot: 是否热卖商品，true或者false
|
||
keyword: 关键字，如果设置则查询是否匹配关键字
|
||
brandId: 品牌商ID，如果设置则查询品牌商所属商品
|
||
categoryId: 商品分类ID，如果设置则查询分类所属商品
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 11,
|
||
"pages": 6,
|
||
"limit": 2,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 1181000,
|
||
"name": "母亲节礼物-舒适安睡组合",
|
||
"brief": "安心舒适是最好的礼物",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/1f67b1970ee20fd572b7202da0ff705d.png",
|
||
"isNew": true,
|
||
"isHot": false,
|
||
"counterPrice": 2618.00,
|
||
"retailPrice": 2598.00
|
||
},
|
||
{
|
||
"id": 1116011,
|
||
"name": "蔓越莓曲奇 200克",
|
||
"brief": "酥脆奶香，甜酸回味",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/767b370d07f3973500db54900bcbd2a7.png",
|
||
"isNew": true,
|
||
"isHot": true,
|
||
"counterPrice": 56.00,
|
||
"retailPrice": 36.00
|
||
}
|
||
],
|
||
"filterCategoryList": [
|
||
{
|
||
"id": 1005007,
|
||
"name": "锅具",
|
||
"keywords": "",
|
||
"desc": "一口好锅，炖煮生活一日三餐",
|
||
"pid": 1005001,
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/4aab4598017b5749e3b63309d25e9f6b.png",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/d2db0d1d0622c621a8aa5a7c06b0fc6d.png",
|
||
"level": "L2",
|
||
"sortOrder": 1,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 1008002,
|
||
"name": "布艺软装",
|
||
"keywords": "",
|
||
"desc": "各种风格软装装点你的家",
|
||
"pid": 1005000,
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/8bbcd7de60a678846664af998f57e71c.png",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/2e2fb4f2856a021bbcd1b4c8400f2b06.png",
|
||
"level": "L2",
|
||
"sortOrder": 6,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 1008008,
|
||
"name": "被枕",
|
||
"keywords": "",
|
||
"desc": "守护你的睡眠时光",
|
||
"pid": 1005000,
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/927bc33f7ae2895dd6c11cf91f5e3228.png",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/b43ef7cececebe6292d2f7f590522e05.png",
|
||
"level": "L2",
|
||
"sortOrder": 2,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 1008009,
|
||
"name": "床品件套",
|
||
"keywords": "",
|
||
"desc": "MUJI等品牌制造商出品",
|
||
"pid": 1005000,
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/243e5bf327a87217ad1f54592f0176ec.png",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/81f671bd36bce05d5f57827e5c88dd1b.png",
|
||
"level": "L2",
|
||
"sortOrder": 4,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 1008015,
|
||
"name": "糕点",
|
||
"keywords": "",
|
||
"desc": "四季糕点，用心烘焙",
|
||
"pid": 1005002,
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/93168242df456b5f7bf3c89653b3db76.png",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/66ea1d6ad602a8e441af7cada93bdc7a.png",
|
||
"level": "L2",
|
||
"sortOrder": 1,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 1012003,
|
||
"name": "文具",
|
||
"keywords": "",
|
||
"desc": "找回书写的力量",
|
||
"pid": 1012000,
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/e1743239e41ca9af76875aedc73be7f0.png",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/e074795f61a83292d0f20eb7d124e2ac.png",
|
||
"level": "L2",
|
||
"sortOrder": 1,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 1020003,
|
||
"name": "服饰",
|
||
"keywords": "",
|
||
"desc": "萌宝穿搭，柔软舒适触感",
|
||
"pid": 1011000,
|
||
"iconUrl": "http://yanxuan.nosdn.127.net/4e50f3c4e4d0a64cd0ad14cfc0b6bd17.png",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/004f5f96df4aeb0645abbd70c0637239.png",
|
||
"level": "L2",
|
||
"sortOrder": 1,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.4.2 商品详情
|
||
|
||
应用场景
|
||
|
||
商品详情
|
||
|
||
接口链接
|
||
|
||
GET /wx/goods/detail
|
||
|
||
请求参数
|
||
|
||
id: 商品ID，例如id=1152008
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"specificationList": [
|
||
{
|
||
"name": "规格",
|
||
"valueList": [
|
||
{
|
||
"id": 231,
|
||
"goodsId": 1152008,
|
||
"specification": "规格",
|
||
"value": "标准",
|
||
"picUrl": "",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
}
|
||
]
|
||
}
|
||
],
|
||
"groupon": [],
|
||
"issue": [
|
||
{
|
||
"id": 1,
|
||
"question": "购买运费如何收取？",
|
||
"answer": "单笔订单金额（不含运费）满88元免邮费；不满88元，每单收取10元运费。\n(港澳台地区需满",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 2,
|
||
"question": "使用什么快递发货？",
|
||
"answer": "严选默认使用顺丰快递发货（个别商品使用其他快递），配送范围覆盖全国大部分地区（港澳台地区除",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 3,
|
||
"question": "如何申请退货？",
|
||
"answer": "1.自收到商品之日起30日内，顾客可申请无忧退货，退款将原路返还，不同的银行处理时间不同，",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 4,
|
||
"question": "如何开具发票？",
|
||
"answer": "1.如需开具普通发票，请在下单时选择“我要开发票”并填写相关信息（APP仅限2.4.0及以",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
}
|
||
],
|
||
"userHasCollect": 0,
|
||
"shareImage": "",
|
||
"comment": {
|
||
"data": [],
|
||
"count": 0
|
||
},
|
||
"attribute": [],
|
||
"brand": {},
|
||
"productList": [
|
||
{
|
||
"id": 232,
|
||
"goodsId": 1152008,
|
||
"specifications": [
|
||
"标准"
|
||
],
|
||
"price": 29.00,
|
||
"number": 100,
|
||
"url": "http://yanxuan.nosdn.127.net/203cb83d93606865e3ddde57b69b9e9a.png",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
}
|
||
],
|
||
"info": {
|
||
"id": 1152008,
|
||
"goodsSn": "1152008",
|
||
"name": "魔兽世界 部落 护腕 一只",
|
||
"categoryId": 1032000,
|
||
"brandId": 0,
|
||
"gallery": [
|
||
"http://yanxuan.nosdn.127.net/46bcddbc57e70bf5f36bdff9c9195c65.png",
|
||
"http://yanxuan.nosdn.127.net/46bcddbc57e70bf5f36bdff9c9195c65.png",
|
||
"http://yanxuan.nosdn.127.net/46bcddbc57e70bf5f36bdff9c9195c65.png",
|
||
"http://yanxuan.nosdn.127.net/46bcddbc57e70bf5f36bdff9c9195c65.png",
|
||
"http://yanxuan.nosdn.127.net/46bcddbc57e70bf5f36bdff9c9195c65.png"
|
||
],
|
||
"keywords": "",
|
||
"brief": "吸汗、舒适、弹性、防护、耐用",
|
||
"isOnSale": true,
|
||
"sortOrder": 7,
|
||
"picUrl": "http://yanxuan.nosdn.127.net/203cb83d93606865e3ddde57b69b9e9a.png",
|
||
"shareUrl": "",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"unit": "件",
|
||
"counterPrice": 49.00,
|
||
"retailPrice": 29.00,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false,
|
||
"detail": ""
|
||
}
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.4.3 商品推荐
|
||
|
||
应用场景
|
||
|
||
针对某个商品推荐其他商品
|
||
|
||
接口链接
|
||
|
||
GET /wx/goods/related
|
||
|
||
请求参数
|
||
|
||
id: 商品ID，例如id=1152008
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 8,
|
||
"pages": 2,
|
||
"limit": 6,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 1152004,
|
||
"name": "魔兽世界 蛋盾包 双肩包",
|
||
"brief": "伊利丹掉落，挤地铁神器",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/8c93cef435d888bd79833777df1cd0c2.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 419.00,
|
||
"retailPrice": 399.00
|
||
},
|
||
{
|
||
"id": 1152008,
|
||
"name": "魔兽世界 部落 护腕 一只",
|
||
"brief": "吸汗、舒适、弹性、防护、耐用",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/203cb83d93606865e3ddde57b69b9e9a.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 49.00,
|
||
"retailPrice": 29.00
|
||
},
|
||
{
|
||
"id": 1152009,
|
||
"name": "魔兽世界 联盟 护腕 一只",
|
||
"brief": "吸汗、舒适、弹性、防护、耐用",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/ae6d41117717387b82dcaf1dfce0cd97.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 49.00,
|
||
"retailPrice": 29.00
|
||
},
|
||
{
|
||
"id": 1152031,
|
||
"name": "魔兽世界-伊利丹颈枕眼罩套装",
|
||
"brief": "差旅好伴侣",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/fd6e78a397bd9e9804116a36f0270b0a.png",
|
||
"isNew": false,
|
||
"isHot": true,
|
||
"counterPrice": 119.00,
|
||
"retailPrice": 99.00
|
||
},
|
||
{
|
||
"id": 1152095,
|
||
"name": "魔兽世界 联盟·暴风城 堡垒收纳盒",
|
||
"brief": "桌面整理神器",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c86b49f635fa141decebabbd0966a6ef.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 519.00,
|
||
"retailPrice": 499.00
|
||
},
|
||
{
|
||
"id": 1152097,
|
||
"name": "魔兽世界 雷霆之怒逐风者的祝福之剑 雨伞",
|
||
"brief": "炫酷装备，可以背的雨伞",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/532836444ae5eaec40b5810ca4f9b1e6.png",
|
||
"isNew": false,
|
||
"isHot": false,
|
||
"counterPrice": 419.00,
|
||
"retailPrice": 399.00
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.4.4 商品分类
|
||
|
||
应用场景
|
||
|
||
针对某个商品推荐其他商品
|
||
|
||
接口链接
|
||
|
||
GET /wx/goods/related
|
||
|
||
请求参数
|
||
|
||
|
||
响应内容
|
||
|
||
错误码
|
||
|
||
#### 2.4.5 在售商品总数
|
||
|
||
应用场景
|
||
|
||
在售商品总数
|
||
|
||
接口链接
|
||
|
||
GET /wx/goods/count
|
||
|
||
请求参数
|
||
|
||
无
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": 238,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
无
|
||
|
||
### 2.5 购物车服务
|
||
|
||
#### 2.5.1 用户购物车
|
||
|
||
应用场景
|
||
|
||
用户购物车
|
||
|
||
接口链接
|
||
|
||
|
||
请求参数
|
||
|
||
无
|
||
|
||
响应内容
|
||
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.6 订单服务
|
||
|
||
#### 2.6.1 订单列表
|
||
|
||
应用场景
|
||
|
||
订单列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/order/list
|
||
|
||
请求参数
|
||
|
||
showType: 订单类型，0则全部，1则待付款，2则待发货，3则待收货，4则代评价
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 1,
|
||
"pages": 1,
|
||
"limit": 10,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"orderStatusText": "未付款",
|
||
"isGroupin": false,
|
||
"orderSn": "20190509607545",
|
||
"actualPrice": 3989.00,
|
||
"goodsList": [
|
||
{
|
||
"number": 1,
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c5be2604c0e4186a4e7079feeb742cee.png",
|
||
"id": 3,
|
||
"goodsName": "云端沙发组合",
|
||
"specifications": [
|
||
"标准"
|
||
]
|
||
}
|
||
],
|
||
"id": 3,
|
||
"handleOption": {
|
||
"cancel": true,
|
||
"delete": false,
|
||
"pay": true,
|
||
"comment": false,
|
||
"confirm": false,
|
||
"refund": false,
|
||
"rebuy": false
|
||
}
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.6.2 订单详情
|
||
|
||
应用场景
|
||
|
||
订单详情
|
||
|
||
接口链接
|
||
|
||
GET /wx/order/detail
|
||
|
||
请求参数
|
||
|
||
orderId： 订单ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"orderInfo": {
|
||
"consignee": "d",
|
||
"address": "北京市市辖区东城区 ddd",
|
||
"addTime": "2019-05-09 15:30:29",
|
||
"orderSn": "20190509607545",
|
||
"actualPrice": 3989.00,
|
||
"mobile": "13811111111",
|
||
"orderStatusText": "未付款",
|
||
"goodsPrice": 3999.00,
|
||
"couponPrice": 10.00,
|
||
"id": 3,
|
||
"freightPrice": 0.00,
|
||
"handleOption": {
|
||
"cancel": true,
|
||
"delete": false,
|
||
"pay": true,
|
||
"comment": false,
|
||
"confirm": false,
|
||
"refund": false,
|
||
"rebuy": false
|
||
}
|
||
},
|
||
"orderGoods": [
|
||
{
|
||
"id": 3,
|
||
"orderId": 3,
|
||
"goodsId": 1109008,
|
||
"goodsName": "云端沙发组合",
|
||
"goodsSn": "1109008",
|
||
"productId": 140,
|
||
"number": 1,
|
||
"price": 3999.00,
|
||
"specifications": [
|
||
"标准"
|
||
],
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c5be2604c0e4186a4e7079feeb742cee.png",
|
||
"comment": 0,
|
||
"addTime": "2019-05-09 15:30:29",
|
||
"updateTime": "2019-05-09 15:30:29",
|
||
"deleted": false
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.6.3 创建订单
|
||
|
||
应用场景
|
||
|
||
创建新订单
|
||
|
||
接口链接
|
||
|
||
POST /wx/order/submit
|
||
|
||
请求参数
|
||
|
||
{
|
||
"cartId": 0,
|
||
"addressId": 3,
|
||
"couponId": -1,
|
||
"message": "",
|
||
"grouponRulesId": 0,
|
||
"grouponLinkId": 0
|
||
}
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"orderId": 4
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.6.4 取消订单
|
||
|
||
应用场景
|
||
|
||
取消订单
|
||
|
||
接口链接
|
||
|
||
POST /wx/order/cancel
|
||
|
||
请求参数
|
||
|
||
orderId: 订单ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.6.5 微信预支付交易单
|
||
|
||
应用场景
|
||
|
||
订单的微信预支付交易单
|
||
|
||
接口链接
|
||
|
||
POST /wx/order/prepay
|
||
|
||
说明
|
||
|
||
具体微信支付交互流程和预支付使用方式，见官方文档: https://pay.weixin.qq.com/wiki/doc/api/wxa/wxa_api.php?chapter=7_3&index=1
|
||
|
||
请求参数
|
||
|
||
orderId: 订单ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
errno: 0,
|
||
errmsg: "成功",
|
||
data: {
|
||
appId: 'xxx',
|
||
timeStamp: 'xxx',
|
||
nonceStr: 'xxx',
|
||
packageValue: 'xxx',
|
||
signType: 'xxx',
|
||
paySign: 'xxx'
|
||
}
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.6.6 确认收货
|
||
|
||
应用场景
|
||
|
||
订单确认收货
|
||
|
||
接口链接
|
||
|
||
POST /wx/order/confirm
|
||
|
||
请求参数
|
||
|
||
orderId: 订单ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.6.7 订单删除
|
||
|
||
应用场景
|
||
|
||
删除订单记录
|
||
|
||
接口链接
|
||
|
||
POST /wx/order/delete
|
||
|
||
请求参数
|
||
|
||
orderId: 订单ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.6.8 订单退款
|
||
|
||
应用场景
|
||
|
||
订单已经支付但是商家未发货，用户可以点击退款按钮申请退款取消订单。
|
||
|
||
说明
|
||
|
||
退款请求发送以后，不会自动退款，仅仅是后端设置退款请求记录。
|
||
管理员在管理后台看到退款请求以后会手动退款或者拒绝退款。
|
||
|
||
接口链接
|
||
|
||
POST /wx/order/refund
|
||
|
||
请求参数
|
||
|
||
orderId: 订单ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.6.9 待评价商品
|
||
|
||
应用场景
|
||
|
||
用户确认收货以后，可以待评价的订单商品。
|
||
|
||
接口链接
|
||
|
||
GET /wx/order/goods
|
||
|
||
请求参数
|
||
|
||
orderId: 订单ID
|
||
goodsId: 商品ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"id": 4,
|
||
"orderId": 4,
|
||
"goodsId": 1109008,
|
||
"goodsName": "云端沙发组合",
|
||
"goodsSn": "1109008",
|
||
"productId": 140,
|
||
"number": 1,
|
||
"price": 3999.00,
|
||
"specifications": [
|
||
"标准"
|
||
],
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c5be2604c0e4186a4e7079feeb742cee.png",
|
||
"comment": 0,
|
||
"addTime": "2019-05-09 17:06:54",
|
||
"updateTime": "2019-05-09 17:06:54",
|
||
"deleted": false
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.6.10 订单评价
|
||
|
||
应用场景
|
||
|
||
订单评价
|
||
|
||
接口链接
|
||
|
||
POST /wx/order/comment
|
||
|
||
请求参数
|
||
|
||
orderGoodsId: 订单商品ID
|
||
content: 评价内容
|
||
star: 评分，1分至5分
|
||
hasPicture: 是否有评价图片
|
||
picUrls: 评价图片列表
|
||
|
||
例如
|
||
|
||
{
|
||
"orderGoodsId": 4,
|
||
"content": "不错",
|
||
"star": 5,
|
||
"hasPicture": true,
|
||
"picUrls": []
|
||
}
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.7 会员服务
|
||
|
||
### 2.8 收货地址服务
|
||
|
||
#### 2.8.1 收货地址列表
|
||
|
||
应用场景
|
||
|
||
用户收货地址列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/address/list
|
||
|
||
请求参数
|
||
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应结果
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 1,
|
||
"pages": 1,
|
||
"limit": 1,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 3,
|
||
"name": "d",
|
||
"userId": 2,
|
||
"province": "北京市",
|
||
"city": "市辖区",
|
||
"county": "东城区",
|
||
"addressDetail": "ddd",
|
||
"areaCode": "110101",
|
||
"tel": "13811111111",
|
||
"isDefault": true,
|
||
"addTime": "2019-05-06 14:17:32",
|
||
"updateTime": "2019-05-06 14:17:32",
|
||
"deleted": false
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.8.2 收货地址详情
|
||
|
||
应用场景
|
||
|
||
请求用户的收货地址详情
|
||
|
||
接口链接
|
||
|
||
GET /wx/address/detail
|
||
|
||
请求参数
|
||
|
||
id: 收货地址ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
errno: 0,
|
||
errmsg: "成功",，
|
||
data: {
|
||
id: 收货地址ID，
|
||
name: 收货人，
|
||
tel: 手机号
|
||
province: 省级行政区域,
|
||
city: 市级行政区域,
|
||
county: 区级行政区域,
|
||
addressDetail: 具体地址,
|
||
areaCode: 地址编码，
|
||
postalCode: 邮政编码
|
||
isDefault: 是否默认
|
||
}
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.8.3 保存收货地址
|
||
|
||
应用场景
|
||
|
||
添加或者更新用户收货地址
|
||
|
||
接口链接
|
||
|
||
POST /wx/address/save
|
||
|
||
请求参数
|
||
|
||
id: 收货地址ID，如果是0则是添加，否则是更新
|
||
name: 收货人，
|
||
tel: 手机号
|
||
province: 省级行政区域,
|
||
city: 市级行政区域,
|
||
county: 区级行政区域,
|
||
addressDetail: 具体地址,
|
||
areaCode: 地址编码，
|
||
postalCode: 邮政编码
|
||
isDefault: 是否默认
|
||
|
||
例如
|
||
|
||
{
|
||
"id": 0,
|
||
"name": "xxx",
|
||
"tel": "13811111111",
|
||
"province": "北京市",
|
||
"city": "市辖区",
|
||
"county": "东城区",
|
||
"areaCode": "110101",
|
||
"addressDetail": "dddd",
|
||
"isDefault": true
|
||
}
|
||
|
||
响应结果
|
||
|
||
{
|
||
errno: 0,
|
||
errmsg: "成功",，
|
||
data: 3
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.8.4 删除收货地址
|
||
|
||
应用场景
|
||
|
||
删除用户的某个收货地址
|
||
|
||
接口链接
|
||
|
||
POST /wx/address/delete
|
||
|
||
请求参数
|
||
|
||
id: 收货地址ID
|
||
|
||
响应结果
|
||
|
||
{
|
||
errno: 0,
|
||
errmsg: "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.9 品牌商服务
|
||
|
||
#### 2.9.1 品牌商列表
|
||
|
||
应用场景
|
||
|
||
访问品牌商列表信息
|
||
|
||
接口链接
|
||
|
||
GET /wx/brand/list
|
||
|
||
请求参数
|
||
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 49,
|
||
"pages": 5,
|
||
"limit": 10,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 1024000,
|
||
"name": "WMF制造商",
|
||
"desc": "严选找寻德国百年高端厨具WMF的制造商，\n选择拥有14年经验的不锈钢生产工厂，\n为你甄选事半功倍的优质厨具。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/2018e9ac91ec37d9aaf437a1fd5d7070.png",
|
||
"floorPrice": 9.90
|
||
},
|
||
{
|
||
"id": 1024001,
|
||
"name": "OBH制造商",
|
||
"desc": "严选寻找OBH品牌的制造商，打造精致厨具，\n韩国独资工厂制造，严格质检，品质雕琢\n力求为消费者带来全新的烹饪体验。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/bf3499ac17a11ffb9bb7caa47ebef2dd.png",
|
||
"floorPrice": 39.00
|
||
},
|
||
{
|
||
"id": 1024003,
|
||
"name": "Stoneline制造商",
|
||
"desc": "严选找寻德国经典品牌Stoneline的制造商，\n追踪工艺，考量细节，亲自试用，\n为你甄选出最合心意的锅具和陶瓷刀，下厨如神。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/3a44ae7db86f3f9b6e542720c54cc349.png",
|
||
"floorPrice": 9.90
|
||
},
|
||
{
|
||
"id": 1024006,
|
||
"name": "KitchenAid制造商",
|
||
"desc": "严选寻访KitchenAid品牌的制造商，\n采用德国LFGB认证食品级专用不锈钢，\n欧式简约设计，可靠安心，尽享下厨乐趣。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/e11385bf29d1b3949435b80fcd000948.png",
|
||
"floorPrice": 98.00
|
||
},
|
||
{
|
||
"id": 1034001,
|
||
"name": "Alexander McQueen制造商",
|
||
"desc": "为制造精致实用的高品质包包，\n严选团队选择Alexander McQueen制造商，\n严格筛选，带来轻奢优雅体验。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/db7ee9667d84cbce573688297586699c.jpg",
|
||
"floorPrice": 69.00
|
||
},
|
||
{
|
||
"id": 1023000,
|
||
"name": "PetitBateau小帆船制造商",
|
||
"desc": "为打造适合宝宝的婴童服装，\n严选团队寻找PetitBateau小帆船的品牌制造商，\n无荧光剂，国家A类标准，让宝宝穿的放心。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/1a11438598f1bb52b1741e123b523cb5.jpg",
|
||
"floorPrice": 36.00
|
||
},
|
||
{
|
||
"id": 1001000,
|
||
"name": "MUJI制造商",
|
||
"desc": "严选精选了MUJI制造商和生产原料，\n用几乎零利润的价格，剔除品牌溢价，\n让用户享受原品牌的品质生活。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/1541445967645114dd75f6b0edc4762d.png",
|
||
"floorPrice": 12.90
|
||
},
|
||
{
|
||
"id": 1001002,
|
||
"name": "内野制造商",
|
||
"desc": "严选从世界各地挑选毛巾，最终选择了为日本内野代工的工厂，追求毛巾的柔软度与功能性。品质比肩商场几百元的毛巾。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/8ca3ce091504f8aa1fba3fdbb7a6e351.png",
|
||
"floorPrice": 29.00
|
||
},
|
||
{
|
||
"id": 1001003,
|
||
"name": "Adidas制造商",
|
||
"desc": "严选找到为Adidas等品牌制造商，\n选取优质原材料，与厂方一起设计，\n为你提供好的理想的运动装备。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/335334d0deaff6dc3376334822ab3a2f.png",
|
||
"floorPrice": 49.00
|
||
},
|
||
{
|
||
"id": 1033003,
|
||
"name": "Armani制造商",
|
||
"desc": "严选团队携手国际标准化专业生产厂家，\n厂家长期为Armani、Alexander wang等知名品牌代工，\n专业进口设备，精密质量把控，精于品质居家体验。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/981e06f0f46f5f1f041d7de3dd3202e6.jpg",
|
||
"floorPrice": 199.00
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.9.2 品牌商详情
|
||
|
||
应用场景
|
||
|
||
访问单个品牌商详情信息
|
||
|
||
接口链接
|
||
|
||
GET /wx/brand/detail
|
||
|
||
请求参数
|
||
|
||
id: 品牌商ID，例如1001020
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"id": 1001020,
|
||
"name": "Ralph Lauren制造商",
|
||
"desc": "我们与Ralph Lauren Home的制造商成功接洽，掌握先进的生产设备，传承品牌工艺和工序。追求生活品质的你，值得拥有。",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/9df78eb751eae2546bd3ee7e61c9b854.png",
|
||
"sortOrder": 20,
|
||
"floorPrice": 29.00,
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.10 收藏服务
|
||
|
||
#### 2.10.1 收藏列表
|
||
|
||
应用场景
|
||
|
||
收藏列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/collect/list
|
||
|
||
请求参数
|
||
|
||
type： 收藏类型，如果是0则是商品收藏，如果是1则是专题收藏
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 2,
|
||
"pages": 1,
|
||
"limit": 10,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"brief": "酥脆奶香，甜酸回味",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/767b370d07f3973500db54900bcbd2a7.png",
|
||
"valueId": 1116011,
|
||
"name": "蔓越莓曲奇 200克",
|
||
"id": 3,
|
||
"type": 0,
|
||
"retailPrice": 36.00
|
||
},
|
||
{
|
||
"brief": "MUJI供应商携手打造",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c5be2604c0e4186a4e7079feeb742cee.png",
|
||
"valueId": 1109008,
|
||
"name": "云端沙发组合",
|
||
"id": 2,
|
||
"type": 0,
|
||
"retailPrice": 3999.00
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.10.2 收藏添加或删除
|
||
|
||
应用场景
|
||
|
||
用户收藏添加或删除
|
||
|
||
说明
|
||
|
||
如果用户已经收藏，则请求API会删除已收藏商品或专题；
|
||
如果用户未收藏，则请求API会添加新的商品或专题收藏记录。
|
||
|
||
接口链接
|
||
|
||
POST /wx/collect/addordelete
|
||
|
||
请求参数
|
||
|
||
type: 收藏类型，如果是0则是商品收藏，如果是1则是专题收藏
|
||
valueId: 收藏对象ID，如果type=0则设置商品ID，如果type=1则设置专题ID
|
||
|
||
例如
|
||
|
||
{
|
||
"type": 0,
|
||
"valueId": 1116011
|
||
}
|
||
|
||
|
||
响应内容
|
||
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.11 评论服务
|
||
|
||
#### 2.11.1 评论数量
|
||
|
||
应用场景
|
||
|
||
某个商品或者专题的评论数量，包括总的评论数量和包含图片的评论数量
|
||
|
||
接口链接
|
||
|
||
GET /wx/comment/count
|
||
|
||
请求参数
|
||
|
||
type: 评论类型，如果是0则是商品评论，如果是1则是专题评论
|
||
valueId: 评论对象ID，如果type=0,则设置商品ID，如果type=0,则设置专题ID
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"hasPicCount": 34,
|
||
"allCount": 96
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
无
|
||
|
||
|
||
#### 2.11.2 评论列表
|
||
|
||
应用场景
|
||
|
||
某个商品或者专题的评论列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/comment/list
|
||
|
||
请求参数
|
||
|
||
valueId=1181000&type=0&limit=20&page=1&showType=0
|
||
type: 评论类型，如果是0则是商品评论，如果是1则是专题评论
|
||
valueId: 评论对象ID，如果type=0,则设置商品ID，如果type=0,则设置专题ID
|
||
showType: 评论显示类型，如果是0则是所有评论，如果是1则是包含图片的评论
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 96,
|
||
"pages": 20,
|
||
"limit": 5,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"userInfo": {
|
||
"nickName": "user123",
|
||
"avatarUrl": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"picList": [
|
||
"https://yanxuan.nosdn.127.net/218783173f303ec6d8766810951d0790.jpg"
|
||
],
|
||
"content": "布料很厚实，触感不错，洗过之后不缩水不掉色"
|
||
},
|
||
{
|
||
"userInfo": {
|
||
"nickName": "user123",
|
||
"avatarUrl": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"picList": [
|
||
"https://yanxuan.nosdn.127.net/33978a0d6f56d94c45e4fc594b4b8606.jpg"
|
||
],
|
||
"content": "料子很舒服，凉凉的，配合蚕丝被，夏天很凉快~"
|
||
},
|
||
{
|
||
"userInfo": {
|
||
"nickName": "user123",
|
||
"avatarUrl": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"picList": [
|
||
"https://yanxuan.nosdn.127.net/d3975d1b6d88e9f9d762cd9a879d1a14.jpg"
|
||
],
|
||
"content": "一直喜欢粗布的床上用品。冬暖夏凉。这套看起来非常漂亮。实际感觉有点粗布的感觉。很好！"
|
||
},
|
||
{
|
||
"userInfo": {
|
||
"nickName": "user123",
|
||
"avatarUrl": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"picList": [
|
||
"https://yanxuan.nosdn.127.net/5fe1121396458cfe0dc1b25ec86f7ff9.jpg",
|
||
"https://yanxuan.nosdn.127.net/d5a55abd6ced5c811d775b04929aaabc.jpg",
|
||
"https://yanxuan.nosdn.127.net/f1764d820ba6ddaf51d297e3cf3826cd.jpg"
|
||
],
|
||
"content": "太好了，舒服的不得了，腰，腿，脊柱，头，颈椎！\n无一处不舒服，真没想到这么优惠！\n搬了新家还要买！"
|
||
},
|
||
{
|
||
"userInfo": {
|
||
"nickName": "user123",
|
||
"avatarUrl": "https://wpimg.wallstcn.com/f778738c-e4f8-4870-b634-56703b4acafe.gif"
|
||
},
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"picList": [
|
||
"https://yanxuan.nosdn.127.net/f753f91430dfb56f574c737d4b2fde46.jpg"
|
||
],
|
||
"content": "抱着试试的态度 先买了小的 果然感觉很舒服 深陷其中 把自己全身心都给了它 第二个床垫已经在路上"
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
无
|
||
|
||
|
||
#### 2.11.3 发表评论
|
||
|
||
应用场景
|
||
|
||
针对某个商品或者专题的发表评论
|
||
|
||
接口链接
|
||
|
||
|
||
请求参数
|
||
|
||
|
||
响应内容
|
||
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.12 优惠券服务
|
||
|
||
|
||
#### 2.12.1 优惠券列表
|
||
|
||
应用场景
|
||
|
||
优惠券列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/coupon/list
|
||
|
||
请求参数
|
||
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 2,
|
||
"pages": 1,
|
||
"limit": 10,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 1,
|
||
"name": "限时满减券",
|
||
"desc": "全场通用",
|
||
"tag": "无限制",
|
||
"discount": 5.00,
|
||
"min": 99.00,
|
||
"days": 10
|
||
},
|
||
{
|
||
"id": 2,
|
||
"name": "限时满减券",
|
||
"desc": "全场通用",
|
||
"tag": "无限制",
|
||
"discount": 10.00,
|
||
"min": 99.00,
|
||
"days": 10
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.12.2 用户优惠券列表
|
||
|
||
应用场景
|
||
|
||
用户优惠券列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/coupon/mylist
|
||
|
||
请求参数
|
||
|
||
status: 优惠券状态，如果0则未使用，如果1则已使用，如果2则已过期
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 2,
|
||
"pages": 1,
|
||
"limit": 10,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 1,
|
||
"name": "限时满减券",
|
||
"desc": "全场通用",
|
||
"tag": "无限制",
|
||
"min": "99.00",
|
||
"discount": "5.00",
|
||
"startTime": "2019-05-06 16:21:38",
|
||
"endTime": "2019-05-16 16:21:38"
|
||
},
|
||
{
|
||
"id": 3,
|
||
"name": "新用户优惠券",
|
||
"desc": "全场通用",
|
||
"tag": "无限制",
|
||
"min": "99.00",
|
||
"discount": "10.00",
|
||
"startTime": "2019-05-06 12:30:06",
|
||
"endTime": "2019-05-16 12:30:06"
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.12.3 下单可用优惠券
|
||
|
||
应用场景
|
||
|
||
当前购物车下单商品订单可用优惠券
|
||
|
||
接口链接
|
||
|
||
GET /wx/coupon/selectlist
|
||
|
||
请求参数
|
||
|
||
cartId: 购物车ID，如果0则是购物车商品，如果非0则是立即单一商品
|
||
grouponRulesId: 团购规则ID，如果是团购商品则需要设置具体团购规则ID
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 1,
|
||
"pages": 1,
|
||
"limit": 1,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 2,
|
||
"name": "限时满减券",
|
||
"desc": "全场通用",
|
||
"tag": "无限制",
|
||
"min": "99.00",
|
||
"discount": "10.00",
|
||
"startTime": "2019-05-09 15:27:29",
|
||
"endTime": "2019-05-19 15:27:29"
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.12.4 优惠券领取
|
||
|
||
应用场景
|
||
|
||
领取优惠券
|
||
|
||
接口链接
|
||
|
||
POST /wx/coupon/receive
|
||
|
||
请求参数
|
||
|
||
couponId： 可领取优惠券ID
|
||
|
||
例如
|
||
|
||
{
|
||
"couponId": 2
|
||
}
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.12.5 优惠券兑换
|
||
|
||
应用场景
|
||
|
||
通过兑换码兑换优惠券
|
||
|
||
接口链接
|
||
|
||
POST /wx/coupon/exchange
|
||
|
||
请求参数
|
||
|
||
code: 优惠券兑换码
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.13 反馈服务
|
||
|
||
### 2.14 足迹服务
|
||
|
||
#### 2.14.1 用户足迹列表
|
||
|
||
应用场景
|
||
|
||
用户足迹列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/footprint/list
|
||
|
||
请求参数
|
||
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 22,
|
||
"pages": 6,
|
||
"limit": 4,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"brief": "酥脆奶香，甜酸回味",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/767b370d07f3973500db54900bcbd2a7.png",
|
||
"addTime": "2019-05-09 10:10:01",
|
||
"goodsId": 1116011,
|
||
"name": "蔓越莓曲奇 200克",
|
||
"id": 22,
|
||
"retailPrice": 36.00
|
||
},
|
||
{
|
||
"brief": "MUJI供应商携手打造",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c5be2604c0e4186a4e7079feeb742cee.png",
|
||
"addTime": "2019-05-09 10:09:49",
|
||
"goodsId": 1109008,
|
||
"name": "云端沙发组合",
|
||
"id": 21,
|
||
"retailPrice": 3999.00
|
||
},
|
||
{
|
||
"brief": "酥脆奶香，甜酸回味",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/767b370d07f3973500db54900bcbd2a7.png",
|
||
"addTime": "2019-05-08 22:40:55",
|
||
"goodsId": 1116011,
|
||
"name": "蔓越莓曲奇 200克",
|
||
"id": 20,
|
||
"retailPrice": 36.00
|
||
},
|
||
{
|
||
"brief": "MUJI供应商携手打造",
|
||
"picUrl": "http://yanxuan.nosdn.127.net/c5be2604c0e4186a4e7079feeb742cee.png",
|
||
"addTime": "2019-05-07 14:35:41",
|
||
"goodsId": 1109008,
|
||
"name": "云端沙发组合",
|
||
"id": 19,
|
||
"retailPrice": 3999.00
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.14.2 用户足迹删除
|
||
|
||
应用场景
|
||
|
||
用户足迹删除
|
||
|
||
接口链接
|
||
|
||
POST /wx/footprint/delete
|
||
|
||
请求参数
|
||
|
||
id: 用户足迹ID
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.15 团购服务
|
||
|
||
注意
|
||
> 团购业务还不完善
|
||
|
||
|
||
#### 2.15.1 团购商品列表
|
||
|
||
应用场景
|
||
|
||
参加团购的商品列表信息
|
||
|
||
接口链接
|
||
|
||
|
||
请求参数
|
||
|
||
|
||
响应内容
|
||
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.15.2 团购活动详情
|
||
|
||
应用场景
|
||
|
||
团购活动详情
|
||
|
||
接口链接
|
||
|
||
|
||
请求参数
|
||
|
||
|
||
响应内容
|
||
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.15.3 参加团购
|
||
|
||
应用场景
|
||
|
||
参加团购的商品列表信息
|
||
|
||
接口链接
|
||
|
||
|
||
请求参数
|
||
|
||
|
||
响应内容
|
||
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
|
||
#### 2.15.4 用户参团列表
|
||
|
||
应用场景
|
||
|
||
用户参团列表
|
||
|
||
接口链接
|
||
|
||
|
||
请求参数
|
||
|
||
|
||
响应内容
|
||
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
### 2.16 帮助服务
|
||
|
||
#### 2.16.1 帮助列表
|
||
|
||
应用场景
|
||
|
||
帮助列表
|
||
|
||
接口链接
|
||
|
||
GET /wx/issue/list
|
||
|
||
请求参数
|
||
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 4,
|
||
"pages": 1,
|
||
"limit": 10,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 1,
|
||
"question": "购买运费如何收取？",
|
||
"answer": "单笔订单金额（不含运费）满88元免邮费；不满88元，每单收取10元运费。\n(港澳台地区需满",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 2,
|
||
"question": "使用什么快递发货？",
|
||
"answer": "严选默认使用顺丰快递发货（个别商品使用其他快递），配送范围覆盖全国大部分地区（港澳台地区除",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 3,
|
||
"question": "如何申请退货？",
|
||
"answer": "1.自收到商品之日起30日内，顾客可申请无忧退货，退款将原路返还，不同的银行处理时间不同，",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
},
|
||
{
|
||
"id": 4,
|
||
"question": "如何开具发票？",
|
||
"answer": "1.如需开具普通发票，请在下单时选择“我要开发票”并填写相关信息（APP仅限2.4.0及以",
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
无
|
||
|
||
### 2.17 搜索服务
|
||
|
||
### 2.18 专题服务
|
||
|
||
#### 2.18.1 专题列表
|
||
|
||
应用场景
|
||
|
||
访问专题列表信息
|
||
|
||
接口链接
|
||
|
||
GET /wx/topic/list
|
||
|
||
请求参数
|
||
|
||
page: 请求页码
|
||
limit: 每一页数量
|
||
sort: 排序字段
|
||
order: 升序降序
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 20,
|
||
"pages": 2,
|
||
"limit": 10,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 264,
|
||
"title": "设计师们推荐的应季好物",
|
||
"subtitle": "原创设计春款系列上新",
|
||
"price": 29.90,
|
||
"readCount": "77.7k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14918201901050274.jpg"
|
||
},
|
||
{
|
||
"id": 266,
|
||
"title": "一条丝巾就能提升时髦度",
|
||
"subtitle": "不知道大家对去年G20时，严选与国礼制造商一起推出的《凤凰于飞》等几款丝巾是否还...",
|
||
"price": 0.00,
|
||
"readCount": "35.0k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14919007135160213.jpg"
|
||
},
|
||
{
|
||
"id": 268,
|
||
"title": "米饭好吃的秘诀：会呼吸的锅",
|
||
"subtitle": "今年1月份，我们联系到了日本伊贺地区的长谷园，那里有着180年伊贺烧历史的窑厂。...",
|
||
"price": 0.00,
|
||
"readCount": "33.3k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14920623353130483.jpg"
|
||
},
|
||
{
|
||
"id": 271,
|
||
"title": "选式新懒人",
|
||
"subtitle": "懒出格调，懒出好生活。",
|
||
"price": 15.00,
|
||
"readCount": "57.7k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14924199099661697.jpg"
|
||
},
|
||
{
|
||
"id": 272,
|
||
"title": "料理也要精细简单",
|
||
"subtitle": "享受天然的味道，日子每天都好新鲜",
|
||
"price": 69.00,
|
||
"readCount": "125.6k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14925200530030186.jpg"
|
||
},
|
||
{
|
||
"id": 274,
|
||
"title": "没有软木拖，怎么过夏天",
|
||
"subtitle": "刚入四月，杭州的气温就已升高至30度。店庆时买了软木拖的用户，陆续发回评价说，很...",
|
||
"price": 0.00,
|
||
"readCount": "46.4k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14925822213780237.jpg"
|
||
},
|
||
{
|
||
"id": 277,
|
||
"title": "治愈生活的满怀柔软",
|
||
"subtitle": "太鼓抱枕的上架历程，是从失踪开始的。由于表面的绒感，最初它被安排在秋冬季上架。某...",
|
||
"price": 0.00,
|
||
"readCount": "19.6k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14926737925770587.jpg"
|
||
},
|
||
{
|
||
"id": 281,
|
||
"title": "条纹新风尚",
|
||
"subtitle": "经典百搭，时尚线条",
|
||
"price": 29.00,
|
||
"readCount": "76.5k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14926859849200826.jpg"
|
||
},
|
||
{
|
||
"id": 282,
|
||
"title": "成就一室笋香",
|
||
"subtitle": "三石哥办公室常备小食推荐",
|
||
"price": 12.00,
|
||
"readCount": "40.9k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14927695046601069.jpg"
|
||
},
|
||
{
|
||
"id": 283,
|
||
"title": "孩子成长中少不了的一双鞋",
|
||
"subtitle": "说起毛毛虫鞋，好处实在太多了，作为一个2岁孩子的宝妈选品员，按捺不住想告诉大家，...",
|
||
"price": 0.00,
|
||
"readCount": "42.5k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14927748974441080.jpg"
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.18.2 专题详情
|
||
|
||
应用场景
|
||
|
||
单个专题详情信息
|
||
|
||
接口链接
|
||
|
||
GET /wx/topic/detail
|
||
|
||
请求参数
|
||
|
||
id: 专题ID，例如 id=264
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"topic": {
|
||
"id": 264,
|
||
"title": "设计师们推荐的应季好物",
|
||
"subtitle": "原创设计春款系列上新",
|
||
"price": 29.90,
|
||
"readCount": "77.7k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14918201901050274.jpg",
|
||
"sortOrder": 0,
|
||
"goods": [],
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false,
|
||
"content": ""
|
||
},
|
||
"goods": []
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
错误码
|
||
|
||
略
|
||
|
||
#### 2.18.3 专题推荐
|
||
|
||
应用场景
|
||
|
||
基于某个专题推荐其他专题
|
||
|
||
接口链接
|
||
|
||
GET /wx/topic/related
|
||
|
||
请求参数
|
||
|
||
id: 专题ID，例如 id=264
|
||
|
||
响应内容
|
||
|
||
{
|
||
"errno": 0,
|
||
"data": {
|
||
"total": 19,
|
||
"pages": 5,
|
||
"limit": 4,
|
||
"page": 1,
|
||
"list": [
|
||
{
|
||
"id": 266,
|
||
"title": "一条丝巾就能提升时髦度",
|
||
"subtitle": "不知道大家对去年G20时，严选与国礼制造商一起推出的《凤凰于飞》等几款丝巾是否还...",
|
||
"price": 0.00,
|
||
"readCount": "35.0k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14919007135160213.jpg",
|
||
"sortOrder": 0,
|
||
"goods": [],
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false,
|
||
"content": "\u003cimg src\u003d\"//yanxuan.nosdn.127.net/75c55a13fde5eb2bc2dd6813b4c565cc.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/e27e1de2b271a28a21c10213b9df7e95.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/9d413d1d28f753cb19096b533d53418d.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/64b0f2f350969e9818a3b6c43c217325.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/a668e6ae7f1fa45565c1eac221787570.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/0d4004e19728f2707f08f4be79bbc774.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/79ee021bbe97de7ecda691de6787241f.jpg\"\u003e"
|
||
},
|
||
{
|
||
"id": 268,
|
||
"title": "米饭好吃的秘诀：会呼吸的锅",
|
||
"subtitle": "今年1月份，我们联系到了日本伊贺地区的长谷园，那里有着180年伊贺烧历史的窑厂。...",
|
||
"price": 0.00,
|
||
"readCount": "33.3k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14920623353130483.jpg",
|
||
"sortOrder": 0,
|
||
"goods": [],
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false,
|
||
"content": "\u003cimg src\u003d\"//yanxuan.nosdn.127.net/75c55a13fde5eb2bc2dd6813b4c565cc.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/e27e1de2b271a28a21c10213b9df7e95.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/9d413d1d28f753cb19096b533d53418d.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/64b0f2f350969e9818a3b6c43c217325.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/a668e6ae7f1fa45565c1eac221787570.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/0d4004e19728f2707f08f4be79bbc774.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/79ee021bbe97de7ecda691de6787241f.jpg\"\u003e"
|
||
},
|
||
{
|
||
"id": 271,
|
||
"title": "选式新懒人",
|
||
"subtitle": "懒出格调，懒出好生活。",
|
||
"price": 15.00,
|
||
"readCount": "57.7k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14924199099661697.jpg",
|
||
"sortOrder": 0,
|
||
"goods": [],
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false,
|
||
"content": "\u003cimg src\u003d\"//yanxuan.nosdn.127.net/75c55a13fde5eb2bc2dd6813b4c565cc.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/e27e1de2b271a28a21c10213b9df7e95.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/9d413d1d28f753cb19096b533d53418d.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/64b0f2f350969e9818a3b6c43c217325.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/a668e6ae7f1fa45565c1eac221787570.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/0d4004e19728f2707f08f4be79bbc774.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/79ee021bbe97de7ecda691de6787241f.jpg\"\u003e"
|
||
},
|
||
{
|
||
"id": 272,
|
||
"title": "料理也要精细简单",
|
||
"subtitle": "享受天然的味道，日子每天都好新鲜",
|
||
"price": 69.00,
|
||
"readCount": "125.6k",
|
||
"picUrl": "https://yanxuan.nosdn.127.net/14925200530030186.jpg",
|
||
"sortOrder": 0,
|
||
"goods": [],
|
||
"addTime": "2018-02-01 00:00:00",
|
||
"updateTime": "2018-02-01 00:00:00",
|
||
"deleted": false,
|
||
"content": "\u003cimg src\u003d\"//yanxuan.nosdn.127.net/75c55a13fde5eb2bc2dd6813b4c565cc.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/e27e1de2b271a28a21c10213b9df7e95.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/9d413d1d28f753cb19096b533d53418d.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/64b0f2f350969e9818a3b6c43c217325.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/a668e6ae7f1fa45565c1eac221787570.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/0d4004e19728f2707f08f4be79bbc774.jpg\"\u003e\n \u003cimg src\u003d\"//yanxuan.nosdn.127.net/79ee021bbe97de7ecda691de6787241f.jpg\"\u003e"
|
||
}
|
||
]
|
||
},
|
||
"errmsg": "成功"
|
||
}
|
||
|
||
### 2.19 对象存储服务
|
||
|
||
### 2.20 其他服务
|
||
|
||
|
||
## 3 管理后台API服务
|
||
|
||
略
|
||
|
||
## 4 更新日志
|
||
|
||
略
|