goods/detail.json

简介

获取某个商品的商品详情信息

请求接口

/shop/api/goods/detail.json

请求方式

post

是否需要登录后才可使用

无需登录

接口响应返回数据的格式

json

请求参数

参数名称 类型 示例值 必须 描述
goodsid int 1 是 要查看的商品id
storeid int 1 否 商铺编号，要获取的数据是属于哪个商铺的
token String dff4214c-4eca-42b8-ad9c-b95afd6374c0 否 当前操作用户的唯一标识。可用 login/getToken.json 获取

返回结果

返回示例

  1. {
  2.   "result": 1,
  3.   "info": "成功",
  4.   "goods": {
  5.     "id": 6,
  6.     "title": "猪肉",
  7.     "inventory": 100,
  8.     "putaway": 1,
  9.     "sale": 1,
  10.     "units": "斤",
  11.     "price": 600,
  12.     "originalPrice": 800,
  13.     "addtime": 1581919619,
  14.     "storeid": 1,
  15.     "typeid": 1,
  16.     "titlepic": "https://cdn.shop.leimingyun.com/goodsList/3b4592a232204fb58a1318e604683ec8.jpg",
  17.     "userBuyRestrict": 0,
  18.     "specification":"[{"黄色":90.1},{"黑色":80},{"白色":70.5}]"
  19.   },
  20.   "goodsImageList": [
  21.     {
  22.       "imageUrl": "https://cdn.shop.leimingyun.com/goodsList/5d5981cf3c02421d909dc3296b2dbfef.jpg"
  23.     },
  24.     {
  25.       "imageUrl": "//cdn.shop.leimingyun.com/goodsList/65800c8de50541e19badfedb7415ede1.jpg"
  26.     },
  27.     {
  28.       "imageUrl": "https://cdn.shop.leimingyun.com/goodsList/dcdc7a35e31d48188c992eba4149c389.jpg"
  29.     }
  30.   ],
  31.   "goodsData": {
  32.     "detail": "<p>我是商品描述..</p>"
  33.   }
  34. }

返回字段说明

参数名称 类型 示例值 描述
result int 1 执行情况。
1:执行成功;
0:执行失败
info String success 若result为0，这里返回失败的原因
若result为1，是执行成功，这里没有什么用
goods JSONObject 商品基本属性信息
goodsImageList JSONArray 商品轮播图列表
goodsData JSONArray 商品的详情信息，也就是富文本编辑器编辑好的商品详情。这里面只有一个 detail 字段，这就是详情
goods 中每项的值说明
参数名称 类型 示例值 描述
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类型
goodsImageList 中每项的值说明
参数名称 类型 示例值 描述
imageUrl String http://www.xxxx.com/123.jpg 图片URL