获取商品详情信息

接口地址:/open-api/product/spu/info

请求方式:GET

接口描述: 根据商品id获取商品详情信息

公共请求参数:

参数名称参数说明请求类型是否必须数据类型示例值
appId应用IDheadertruestringtest
nonce随机字符串headertruestring75ba4a58-8db0-4ce0-b403-2ccc8dbaea72
timestamp时间戳headertruestring1772763315016
sign签名串headertruestring89f4ad32ea7151cc33477215c24e8020bfb801a9a805a1369d9d6ceddc67a7e4

业务请求参数

参数名称参数说明请求类型是否必须数据类型示例值
id商品idquerytruenumber1

请求示例

https://fjgs-gateway.imageco.cn/open-api/product/spu/info?id=1

响应参数:

参数名称参数说明类型示例值
code返回码integer0
msg返回信息string
data业务数据JSONObject参考data业务数据

data 业务数据 (JSONObject)

参数名称参数说明类型示例值
id商品idnumber1711064111
name商品名称string测试商品名称
introduction商品简介string555
description商品详细描述string商品描述
categoryId分类idnumber1036135111
categoryName分类名称string饮料
brandId品牌idnumber1100111025
brandName品牌名称string测试品牌001
independentOperation是否独立运营[0:否, 1:是]number0
shelfLife保质期数值number5
shelfLifeUnit保质期单位[1-天,2-月,3-年]number1
isSupportNoReasonReturn是否支持7天无理由退货[0:否, 1:是]booleantrue
picUrl主图URLstringurl
sliderPicUrls轮播图URL数组array of string[“url”,”url1”,”url2”]
mediaUrl媒体文件URL(视频等)string / nullnull
keyword关键词string55
attributes自定义属性数组[json数组]array[]
serviceTel服务电话string“55555555”
traceabilityUrl追溯信息URLstring / nullnull
specType是否多规格booleantrue
price商品售价(单位:分)number100
marketPrice市场价(单位:分)number531500
stock总库存number114208
type商品类型[1:普通商品, 2:虚拟商品, 3:票付通商品]number1
deliveryTypes配送方式数组[1:快递发货, 2:用户自提, 3:卡密卡号, 4:电子券码]array of number[1,2]
skusSKU列表(详见下方子表)array of object见子表
salesCount销量number2

skus 子表(每个SKU对象字段):

参数名称参数说明类型示例值
idSKU idnumber50321821
properties规格属性数组array of object[{“propertyId”:425,”propertyName”:”口味”,”valueId”:60243938,”valueName”:”西瓜”}]
priceSKU售价(分)number100
marketPriceSKU市场价(分)number5500
vipPrice会员价(分),可为nullnumber / nullnull
picUrlSKU图片URLstring“”
stockSKU库存number553
weight重量(千克)number0
volume体积(立方米)number0

响应成功示例:

  1. {
  2. "code": 0,
  3. "msg": "",
  4. "data": {
  5. "code": 0,
  6. "msg": "",
  7. "data": {
  8. "id": 1711064111,
  9. "name": "测试商品名称",
  10. "introduction": "555",
  11. "description": "商品描述",
  12. "categoryId": 1036135111,
  13. "categoryName": "饮料",
  14. "brandId": 1100111025,
  15. "brandName": "测试品牌001",
  16. "independentOperation": 0,
  17. "shelfLife": 5,
  18. "shelfLifeUnit": 1,
  19. "isSupportNoReasonReturn": true,
  20. "picUrl": "url",
  21. "sliderPicUrls": [
  22. "url",
  23. "url1",
  24. "url2"
  25. ],
  26. "mediaUrl": null,
  27. "keyword": "55",
  28. "attributes": [
  29. ],
  30. "serviceTel": "55555555",
  31. "traceabilityUrl": null,
  32. "specType": true,
  33. "price": 100,
  34. "marketPrice": 531500,
  35. "stock": 114208,
  36. "type": 1,
  37. "deliveryTypes": [
  38. 1,
  39. 2
  40. ],
  41. "skus": [
  42. {
  43. "id": 50321821,
  44. "properties": [
  45. {
  46. "propertyId": 425,
  47. "propertyName": "口味",
  48. "valueId": 60243938,
  49. "valueName": "西瓜"
  50. }
  51. ],
  52. "price": 100,
  53. "marketPrice": 5500,
  54. "vipPrice": null,
  55. "picUrl": "",
  56. "stock": 553,
  57. "weight": 0,
  58. "volume": 0
  59. },
  60. {
  61. "id": 501493822,
  62. "properties": [
  63. {
  64. "propertyId": 425,
  65. "propertyName": "口味",
  66. "valueId": 60242936,
  67. "valueName": "苹果"
  68. }
  69. ],
  70. "price": 100,
  71. "marketPrice": 5500,
  72. "vipPrice": null,
  73. "picUrl": "",
  74. "stock": 555,
  75. "weight": 0,
  76. "volume": 0
  77. }
  78. ],
  79. "salesCount": 2
  80. }
  81. }
  82. }

响应失败示例:

  1. {
  2. "code": 400,
  3. "msg": "签名不正确",
  4. "data": null
  5. }
  1. {
  2. "code": 200,
  3. "msg": "",
  4. "data": null
  5. }