商品
分类
/product/category/get 获取商品分类
接口名: /product/category/get
Method: GET
请求:
salemenu_ids O list 销售单ID列表
响应:
code M int 返回码 0为成功、其他为错误
msg O string 出错信息提示
data O list 成功时返回数据，json格式
[{
name M string 一级分类名
id M string 一级分类ID
children M list 二级分类信息
[{
id M string 二级分类ID
name M string 二级分类名
first_category_id M string 所属一级分类ID
}]
}]
示例:
request:
http://testbshop.guanmai.cn/product/category/get
response:
{
data: [{
name: "蔬菜",
children: [{
name: "叶菜类",
first_category_id: "A101",
id: "B101"
}],
id: "A101"
}],
code: 0
}
逻辑:
获取销售单ID
获取普通分类
获取销售单下的商品
统计商品的分类信息
获取营销分类
获取销售单下的营销分类信息
格式化分类信息数据
返回
商品
/product/sku/get 获取指定分类的商品
接口名: /product/sku/get
Method: GET
请求:
category_id M string 分类ID
level O int 分类级别 默认一级分类
salemenu_ids O list 销售单ID列表
响应:
code M int 返回码 0为成功、其他为错误
msg O string 出错信息提示
data O list 成功时返回数据，json格式
[{
img_url: spu图片链接,
id: spu_id,
name: spu名称,
is_fav: 是否已收藏,
std_unit_name: 基本单位,
std_sale_price: 售卖价格,
cart_amount: 加入购物车数量,
skus: [{
name: sku名称,
sale_unit_name: 售卖单位,
std_sale_price: 基本单位价格,
sale_ratio: 换算率(售卖单位/基本单位),
img_url: sku图片链接,
sale_num_least: 最小下单数量,
state: 上架状态(1:上架;0:下架),
category_id_1: 一级分类ID,
sale_price: 售卖价格,
is_valid: 是否有效(在用户的销售单内),
rule_price: 规则价格,
desc: 描述,
id: sku_id,
search_key: 搜索的二级分类ID 前端用,
std_unit_name: 基本单位,
category_id_2: 二级分类ID,
stocks: 库存数量,
station_id: 站点ID,
cart_amount: 加入采购单数量,
salemenu_id: 销售单ID,
spu_id: spu_id,
sort_id: 排序ID(给有排序需求的站点使用)
}],
salemenu_id: 销售单ID,
sort_id: 排序ID(给有排序需求的站点使用)
}]
示例:
request:
http://testbshop.guanmai.cn/product/sku/get?level=2&category_id=B101
response:
{
data: [{
img_url: "https://bshop.guanmai.cn/static/productpic/f43b8093de95310f.jpg",
id: "C00001",
name: "白菜苔",
is_fav: false,
std_unit_name: "斤",
std_sale_price: 530,
cart_amount: 0,
skus: [{
name: "白菜苔|斤",
sale_unit_name: "斤",
std_sale_price: 530,
sale_ratio: 1,
img_url: "https://bshop.guanmai.cn/static/productpic/f43b8093de95310f.jpg",
sale_num_least: 1,
state: 1,
category_id_1: "A101",
sale_price: 530,
is_valid: true,
rule_price: null,
desc: "湖南产",
id: "D948733",
search_key: "B101",
std_unit_name: "斤",
category_id_2: "B101",
stocks: 0,
station_id: "T208",
cart_amount: 0,
salemenu_id: "S0599",
spu_id: "C00001",
sort_id: 0
}],
salemenu_id: "S0599",
sort_id: 0
}],
code: 0
}
逻辑:
获取销售单ID
普通分类(以A|B开头)
获取销售单下指定分类的商品
营销分类
获取销售单下指定的营销分类
获取营销分类的sku_ids
通过sku_ids拉取商品
格式化商品数据
返回
/product/sku/search 根据名称搜索商品
接口名: /product/sku/search
Method: GET
请求:
text M string 商品名称
响应:
code M int 返回码 0为成功、其他为错误
msg O string 出错信息提示
data O list 成功时返回数据，json格式
[{
img_url: spu图片链接,
id: spu_id,
name: spu名称,
is_fav: 是否已收藏,
std_unit_name: 基本单位,
std_sale_price: 售卖价格,
cart_amount: 加入购物车数量,
skus: [{
name: sku名称,
sale_unit_name: 售卖单位,
std_sale_price: 基本单位价格,
sale_ratio: 换算率(售卖单位/基本单位),
img_url: sku图片链接,
sale_num_least: 最小下单数量,
state: 上架状态(1:上架;0:下架),
category_id_1: 一级分类ID,
sale_price: 售卖价格,
is_valid: 是否有效(在用户的销售单内),
rule_price: 规则价格,
desc: 描述,
id: sku_id,
std_unit_name: 基本单位,
category_id_2: 二级分类ID,
stocks: 库存数量,
station_id: 站点ID,
cart_amount: 加入采购单数量,
salemenu_id: 销售单ID,
spu_id: spu_id,
sort_id: 排序ID(给有排序需求的站点使用)
}],
salemenu_id: 销售单ID,
sort_id: 排序ID(给有排序需求的站点使用)
}]
示例:
request:
http://testbshop.guanmai.cn/product/sku/search?text=白菜
response:
{
data: [{
img_url: "https://bshop.guanmai.cn/static/productpic/f43b8093de95310f.jpg",
id: "C00001",
name: "白菜苔",
is_fav: false,
std_unit_name: "斤",
std_sale_price: 530,
cart_amount: 0,
skus: [{
name: "白菜苔|斤",
sale_unit_name: "斤",
std_sale_price: 530,
sale_ratio: 1,
img_url: "https://bshop.guanmai.cn/static/productpic/f43b8093de95310f.jpg",
sale_num_least: 1,
state: 1,
category_id_1: "A101",
sale_price: 530,
is_valid: true,
rule_price: null,
desc: "湖南产",
id: "D948733",
std_unit_name: "斤",
category_id_2: "B101",
stocks: 0,
station_id: "T208",
cart_amount: 0,
salemenu_id: "S0599",
spu_id: "C00001",
sort_id: 0
}],
salemenu_id: "S0599",
sort_id: 0
}],
code: 0
}
逻辑:
获取商户销售单ID
根据商品名称搜索sku
格式化商品数据
返回
/product/sku/everyday 每日精选商品
接口名: /product/sku/everyday
Method: GET
请求:
无
响应:
code M int 返回码 0为成功、其他为错误
msg O string 出错信息提示
data O list 成功时返回数据，json格式
[{
img_url: spu图片链接,
id: spu_id,
name: spu名称,
is_fav: 是否已收藏,
std_unit_name: 基本单位,
std_sale_price: 售卖价格,
cart_amount: 加入购物车数量,
skus: [{
name: sku名称,
sale_unit_name: 售卖单位,
std_sale_price: 基本单位价格,
sale_ratio: 换算率(售卖单位/基本单位),
img_url: sku图片链接,
sale_num_least: 最小下单数量,
state: 上架状态(1:上架;0:下架),
category_id_1: 一级分类ID,
sale_price: 售卖价格,
is_valid: 是否有效(在用户的销售单内),
rule_price: 规则价格,
desc: 描述,
id: sku_id,
std_unit_name: 基本单位,
category_id_2: 二级分类ID,
stocks: 库存数量,
station_id: 站点ID,
cart_amount: 加入采购单数量,
salemenu_id: 销售单ID,
spu_id: spu_id,
sort_id: 排序ID(给有排序需求的站点使用)
}],
salemenu_id: 销售单ID,
sort_id: 排序ID(给有排序需求的站点使用)
}]
示例:
request:
http://testbshop.guanmai.cn/product/sku/everyday
response:
{
data: [{
img_url: "https://bshop.guanmai.cn/static/productpic/f43b8093de95310f.jpg",
id: "C00001",
name: "白菜苔",
is_fav: false,
std_unit_name: "斤",
std_sale_price: 530,
cart_amount: 0,
skus: [{
name: "白菜苔|斤",
sale_unit_name: "斤",
std_sale_price: 530,
sale_ratio: 1,
img_url: "https://bshop.guanmai.cn/static/productpic/f43b8093de95310f.jpg",
sale_num_least: 1,
state: 1,
category_id_1: "A101",
sale_price: 530,
is_valid: true,
rule_price: null,
desc: "湖南产",
id: "D948733",
std_unit_name: "斤",
category_id_2: "B101",
stocks: 0,
station_id: "T208",
cart_amount: 0,
salemenu_id: "S0599",
spu_id: "C00001",
sort_id: 0
}],
salemenu_id: "S0599",
sort_id: 0
}],
code: 0
}
逻辑:
获取商户销售单ID
获取营销分类
统计营销分类的商品数量
存在商品则拉取商品信息
不存在商品则拉取最新修改的商品
格式化商品数据
返回
/product/hot_search 获取热搜品类名称
接口名: /product/hot_search
Method: GET
请求:
todo
响应:
todo
/product/spu/remark/get 获取spu备注
接口名: /product/spu/remark/get
Method: GET
请求:
todo
响应:
todo
/product/spu/remark/update 更新spu备注
接口名: /product/spu/remark/update
Method: POST
请求:
todo
响应:
todo
新品需求
product/image/upload 「商品需求描述图片上传」
跳转链接： product/image/upload
product/station/list 「使用 cms_key 和 店铺绑定的 salemenu_id 获取服务站点」
跳转链接： product/station/list