shop goods - shileishmily/YytRPC GitHub Wiki
1. 商城首页接口
接口地址:/goods/home
接口交互:GET
接口描述:商城首页接口
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
| materialList | jsonarray | 材料区 |
| materialColspan | int | 材料区分几列显示 |
| equipmentList | jsonarray | 设备区 |
| equipmentColspan | int | 设备区分几列显示 |
| hotProductList | jsonarray | 热门产品 |
| hotProductColspan | int | 热门产品分几列显示 |
materialList数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| title | string | 标题 | |
| describe | string | 描述 | |
| imgUrl | string | 图片 | |
| forwardUrl | string | 跳转地址 | 点击“查看更多”跳转类分类页面 |
equipmentList数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| title | string | 标题 | |
| describe | string | 描述 | |
| imgUrl | string | 图片 | |
| forwardUrl | string | 跳转地址 | 点击“查看更多”跳转类分类页面 |
hotProductList数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| title | string | 标题 | |
| imgUrl | string | 图片 | |
| forwardUrl | string | 跳转地址 | 点击产品跳转到产品详情页面 |
| price | double | 价格（单位：元） | 18.8 |
| costPrice | double | 原价（单位：元） | 23.5 |
| rebate | double | 折扣 | 7.0（7折） |
2. 商品详情接口
接口地址:/goods/detail
接口交互:GET
接口描述:商城首页接口
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
query入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| goodsId | 111 | M | 商品ID |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
| result | json object | 材料区 |
result数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| goodsImgs | string[] | 商品图片地址数组 | |
| goodsTitle | string | 商品标题 | |
| price | double | 价格（单位：元） | |
| costPrice | double | 原价（单位：元） | 23.5 |
| unit | string | 计价单位 | 例如：盒、箱、桶 |
| rebate | double | 折扣 | 7.0（7折） |
| modelList | jsonarray | 型号 | [{code:"123",name:"POP-E黄"}{code:"234",name:"POP-E红"}] |
| specList | jsonarray | 规格 | [{code:"666",name:"12罐/箱"}{code:"777",name:"24罐/箱"}] |
3. 商品型号规格查询接口
接口地址:/goods/marque
接口交互:GET
接口描述:商品型号规格查询接口
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
query入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| goodsId | 111 | M | 商品ID |
响应
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| status | string | 0000：成功 | |
| message | string | 提示 | |
| modelList | jsonarray | 型号 | [{code:"123",name:"POP-E黄"}{code:"234",name:"POP-E红"}] |
| specList | jsonarray | 规格 | [{code:"666",name:"12罐/箱"}{code:"777",name:"24罐/箱"}] |
4. 商品评价记录
接口地址:/goods/rateList
接口交互:GET
接口描述:商品评价记录
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
query入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| goodsId | 111 | M | 商品ID |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
| rateNum | int | 评价总数 |
| favourableRate | double | 好评率(99.99表示好评率99.99%) |
| result | jsonarray | 评价记录 |
result数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| nickname | string | 用户昵称 | 中间字母隐藏，例如：我爱***国 |
| starNum | double | 评价星数 | 最大值5，4.5表示4星半 |
| rateDate | string | 评价日期 | 格式：yyyy-MM-dd |
| rateContent | string | 评价内容 | |
| spec | string | 型号规格 | 型号：POP-E黄 规格：12罐/箱 |
5. 查询下一级子分类
接口地址:/goods/classifyQuery
接口交互:GET
接口描述:查询下一级子分类
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
query入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| classifyId | 111 | M | 商品分类ID |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
| result | jsonarray | 商品分类List |
result数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| classifyId | int | 分类ID | |
| classifyName | string | 分类名称 |
6. 查询某分类下的所有叶子分类
接口地址:/goods/queryByClassifyId
接口交互:GET
接口描述:查询某分类下的所有叶子分类
header入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| ak | 0130000 | M | 版本号 |
| sessionid | 20161110124538 | M | 会话ID |
| userid | 66666 | M | 用户id |
query入参
| Parameter | Sample value | Optional | Description |
|---|---|---|---|
| classifyId | 111 | M | 商品分类ID |
响应
| Parameter | 描述 | 例子 |
|---|---|---|
| status | string | 0000：成功 |
| message | string | 提示 |
| classifyList | jsonarray | 叶子分类列表 |
productList数据结构
| Parameter | 类型 | 描述 | 例子 |
|---|---|---|---|
| title | string | 类别标题 | |
| imgUrl | string | 图片 | |
| forwardUrl | string | 跳转地址 | 点击跳转到商品展示页面，显示该分类下的所有商品 |