接口描述:

  • 获取一个商品。

请求 URL:

  • http|https://host/api/v1/goods/method/get.goods.item/

请求方式:

  • GET
  • POST

是否授权:

业务参数:

参数名 类型 是否必须 范围值 默认值 示例值 描述
goods_id integer gt:0 5 商品编号

响应参数:

参数名 类型 是否返回 示例值 描述
status integer 200 状态码
message string success 消息信息
data object [] 返回对象
data 类型 是否返回 示例值 描述
goods_id integer 5 商品编号
goods_category_id integer 1 商品分类编号
name string MateBook 商品名称
short_name string MateBook 商品短名称
product_name string XXX促销 商品促销名
goods_code string CS91785250 商品货号
goods_spu string 123456 商品SPU
goods_sku string 654321 商品SKU
bar_code string 123456 商品条码
brand_id integer 1 商品品牌编号
store_qty integer 200 商品库存
comment_sum integer 0 评价数量
sales_sum integer 0 销售数量
measure number 3 商品计量(重量、体积)
measure_type integer 0 计量方式 0=重量 1=计件 2=体积
is_postage integer 1 是否包邮 0=收费 1=包邮
market_price number 7000 商品市场价
shop_price number 5400 商品本店价
integral_type integer 0 赠送积分结算方式
give_integral number 540 商品赠送积分
is_integral integer 1000 积分可抵扣额
least_sum integer 1 最少起订量
purchase_sum integer 2 限购数量
keywords string 华为 商品关键词
description string 笔记本 商品描述
content string 详情页 商品详情描述
attachment array ["//image_1.jpg"] 商品相册
video string //video.mp4 商品短视频
unit string 商品计量单位
is_recommend integer 1 是否推荐 0=不推 1=推荐
is_new integer 1 是否新品 0=不新 1=新品
is_hot integer 1 是否热卖 0=普通 1=热卖
goods_type_id integer 1 商品模型编号
sort integer 50 排序值
status integer 1 上下架状态 0=下架 1=上架
is_delete integer 0 商品状态 0=正常 1=回收
create_time datetime 2018-05-23 00:25:09 创建时间
update_time datetime 2018-05-23 00:25:09 更新时间
goods_spec_item array [] 商品规格列表数组
spec_image array [] 商品规格图数组
goods_attr_item array [] 商品属性列表数组
goods_spec_item 类型 是否返回 示例值 描述
key_name string 1_3 商品规格键名
key_value string 颜色:黑色 CPU:I5 商品规格值
price number 5400 商品价格
store_qty integer 100 商品库存
bar_code string 123456 商品条码
goods_sku string 654321 商品SKU
spec_image 类型 是否返回 示例值 描述
spec_item_id integer 1 商品规格项编号
image string //image_1.jpg 商品规格图片
goods_attr_item 类型 是否返回 示例值 描述
goods_attribute_id integer 1 商品属性编号
parent_id integer 0 商品属性主体
is_important integer 1 是否核心属性 0=普通 1=核心
attr_value string I5 I7 属性值
sort integer 50 排序值

响应示例:

  1. {
  2. "status": 200,
  3. "message": "success",
  4. "data": {
  5. "goods_id": 5,
  6. "goods_category_id": 1,
  7. "name": "MateBook",
  8. "short_name": "MateBook",
  9. "product_name": "XXX促销",
  10. "goods_code": "CS91785250",
  11. "goods_spu": "123456",
  12. "goods_sku": "654321",
  13. "bar_code": "123456",
  14. "brand_id": 1,
  15. "store_qty": 200,
  16. "comment_sum": 0,
  17. "sales_sum": 0,
  18. "measure": 3,
  19. "measure_type": 0,
  20. "is_postage": 1,
  21. "market_price": 7000,
  22. "shop_price": 5400,
  23. "integral_type": 0,
  24. "give_integral": 540,
  25. "is_integral": 1000,
  26. "least_sum": 1,
  27. "purchase_sum": 2,
  28. "keywords": "华为",
  29. "description": "笔记本",
  30. "content": "详情页",
  31. "attachment": [
  32. "//image_1.jpg"
  33. ],
  34. "video": "//video.mp4",
  35. "unit": "件",
  36. "is_recommend": 1,
  37. "is_new": 1,
  38. "is_hot": 1,
  39. "goods_type_id": 1,
  40. "sort": 50,
  41. "status": 1,
  42. "is_delete": 0,
  43. "create_time": "2018-05-23 00:25:09",
  44. "update_time": "2018-05-23 00:25:09",
  45. "goods_spec_item": [
  46. {
  47. "key_name": "1_3",
  48. "key_value": "颜色:黑色 CPU:I5",
  49. "price": 5400,
  50. "store_qty": 100,
  51. "bar_code": "",
  52. "goods_sku": ""
  53. },
  54. {
  55. "key_name": "1_4",
  56. "key_value": "颜色:黑色 CPU:I7",
  57. "price": 5900,
  58. "store_qty": 100,
  59. "bar_code": "",
  60. "goods_sku": ""
  61. }
  62. ],
  63. "spec_image": [
  64. {
  65. "spec_item_id": 1,
  66. "image": "//image_1.jpg"
  67. },
  68. {
  69. "spec_item_id": 2,
  70. "image": "//image_2.jpg"
  71. }
  72. ],
  73. "goods_attr_item": [
  74. {
  75. "goods_attribute_id": 1,
  76. "parent_id": 0,
  77. "is_important": 1,
  78. "attr_value": "I5 I7",
  79. "sort": 50
  80. },
  81. {
  82. "goods_attribute_id": 2,
  83. "parent_id": 0,
  84. "is_important": 1,
  85. "attr_value": "8G 16G",
  86. "sort": 50
  87. }
  88. ]
  89. }
  90. }

备注:

文档更新时间: 2018-06-22 22:13