商城
  1. 产品->详情
商城
  • 评论
    • productReview
      POST
    • reviewSkuList
      POST
    • reviewLike
      POST
    • reviewTag
      POST
    • orderDetail
      POST
    • 图片或视频上传或其他类型文件上传
      POST
    • 图片
      POST
    • 评论提交
      POST
    • 评论详情
      POST
    • 评论翻译
      POST
  • souring相关
    • 站点->sourcing
      • 商品 -> 图片搜索
        • 阿里云以图搜图
        • 阿里云以图搜图V2
      • sourcing提交
      • sourcing详情
      • sourcing取消
      • sourcing分页查询
      • sourcing商品查询
  • 站点->sourcing
    • 数量查询
  • 购物车 -> 购物车
    • deteleCartSync
    • test
    • test2
    • 合并购物车
    • 查询购物车仓库列表
    • 查询购物车数量
    • 删除购物车
    • 更新免邮勾选
    • 移动到心愿单
    • 更新购物车
    • 加购购物车
    • studio样品加入购物车
    • 购物车列表查询
    • 查询spu下所有sku查询在购物车中的数量
    • 删除原来sku,新增sku
  • 个人中心->订单管理
    • 订单分页列表
    • 查看订单详情
    • 获取订单中已变成一包多件的商品详情
    • 同步item数据
    • 备货详情
    • Pay now待支付订单信息
    • 查看订单概览
    • 标记等待补货
    • 待支付订单信息
    • 缺货继续支付
    • 支付成功回显订单地址信息
    • 编辑订单地址
    • 订单备注
    • 导出发货清单
    • 从服务器下载已保存的checklist文件
    • 上传支付凭证
    • 获取订单图片zip下载链接
    • studio-获取订单发票信息
  • 产品->详情
    • 查询sku详情(列表页弹框)
      POST
    • 设置log
      POST
    • 查询sku详情(商品详情)
      POST
    • 计算商详sku价格
      POST
    • 批量获取商品详情
      POST
    • 批量获取供应商产品详情
      POST
    • 查询sku活动
      POST
    • 查询商品的活动配置折扣信息以及分类活动的code
      POST
    • 推荐商品
      POST
    • 推荐关键词
      POST
    • 图片压缩包
      POST
    • 墨西哥免邮商品刷新
      GET
    • 商品发货交货时效信息
      POST
    • 获取二维码的sku编码,判别二维码是否有效(是否查询的到产品)
      POST
    • 获取不同站点对应链接
      POST
    • 获取经常购买的商品
      POST
    • 遗失物品赔偿
      POST
    • 墨西哥商品利益点文案
      POST
    • 商品关联博客列表
      POST
  • 订单 -> 订单
    • create
    • google or apple
    • reorder
    • reviewToWish
    • getOrderList
    • orderAgeing
    • orderNumberGenerator
    • 获取订单优惠信息
  • 站点->支付方式
    • list
    • 根据站点获取paypal的clientId 默认是饰品站
    • 复制站点支付方式
  • 产品搜索->列表
    • 列表分页
    • 图搜商品
    • ERP分页查询
    • 查询类目
    • 根据类目ID查询关键字
    • 获取所有语言的属性名
    • 刷新属性缓存
    • 刷新关键字缓存
    • 用户历史关键词搜索查询
    • 热门关键词和分类搜索
    • 删除用户历史关键词搜索查询
    • 清除缓存关键词
    • 根据spues获取商品列表
    • 新人专享页面数据
    • 新人专享页面数据v2版本
    • 流失客户推广专题页模块
    • 流失客户推广专题页模块
    • 新人专享页面免邮门槛图片v2版本
    • 购买过查询
    • 历史浏览记录
  • 购物车 -> 结算
    • checkout
    • checkoutOptimization
    • prepareCheckout
    • loginCheckout
    • countryProhibition
    • countryProhibitionConfirm
    • ageingInfo
  • 商品详情->激光定制
    • 激光定制模板查询
    • 激光定制提交
    • 激光定制分页查询
    • 激光定制详情
  • 商品定制
    • 定制商品需求提交
    • 定制商品列表
    • 定制商品需求 详情
  • 多买多奖
    • 获取活动信息
  1. 产品->详情

查询sku详情(商品详情)

POST
/st-pse/info/product-sku

请求参数

Body 参数application/json
spu
string 
可选
sku
string 
可选
spuList
array[string]
可选
activityCode
integer 
可选
url
string 
可选
pageSource
string 
可选
bytemUid
string 
可选
siteId
integer 
可选
queryAll
boolean 
可选
默认值:
true
inventoryType
integer 
可选
country
string 
可选
changeInventory
integer 
可选
filterLabel
integer 
可选
查询sku详情携带的标识, 2: 代发
categoryId
integer 
类目ID
可选
originType
string 
可选
pageSize
integer 
可选
默认值:
20
pageNum
integer 
可选
默认值:
1
onShareSpu
string 
可选
sku共享被挂spu
示例
{
    "spu": "string",
    "sku": "string",
    "spuList": [
        "string"
    ],
    "activityCode": 0,
    "url": "string",
    "pageSource": "string",
    "bytemUid": "string",
    "siteId": 0,
    "queryAll": true,
    "inventoryType": 0,
    "country": "string",
    "changeInventory": 0,
    "filterLabel": 0,
    "categoryId": 0,
    "originType": "string",
    "pageSize": 20,
    "pageNum": 1,
    "onShareSpu": "string"
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://www.nihaocloud.cn/st-pse/info/product-sku' \
--header 'Content-Type: application/json' \
--data-raw '{
    "spu": "string",
    "sku": "string",
    "spuList": [
        "string"
    ],
    "activityCode": 0,
    "url": "string",
    "pageSource": "string",
    "bytemUid": "string",
    "siteId": 0,
    "queryAll": true,
    "inventoryType": 0,
    "country": "string",
    "changeInventory": 0,
    "filterLabel": 0,
    "categoryId": 0,
    "originType": "string",
    "pageSize": 20,
    "pageNum": 1,
    "onShareSpu": "string"
}'

返回响应

🟢200成功
application/json
Body
商品详情信息
sameMiniSale
integer 
可选
相同最小起订量(所有SKU相同情况下会有值)
detailUrl
string 
商详链接
可选
url
string 
可选
name
string 
可选
spu
string 
可选
imgList
array[string]
商品图
可选
img
string 
商品主图
可选
imgInfoList
array[string]
详情图
可选
video
string 
商品视频
可选
videoDuration
string 
视频时长
可选
videoImgUrl
array[string]
视频第一帧图
可选
videoCover
string 
视频封面图
可选
salesCount
integer 
可选
reviewScore
number 
可选
reviewNum
integer 
评论数
可选
crumbs
array[object (CrumbVo) {4}] 
可选
name
string 
可选
url
string 
可选
id
integer 
可选
categroyId
integer 
可选
bestSellerResult
object (BestSellerResult) 
榜单信息
可选
mainCategoryId
integer 
主类目id
可选
mainCategoryName
string 
主类目名称
可选
rank
integer 
当前排名
可选
rank10d
integer 
10天排名
可选
detailJson
string 
可选
sizeRatioJson
string 
可选
sizeRatioUnitJson
string 
可选
tdk
object (TdkVo) 
商品详情信息
可选
title
string 
可选
description
string 
可选
keywords
string 
可选
icon
string 
可选
pageTitle
string 
可选
discount
number 
商品级别 最大折扣
可选
minPrice
number 
价格
可选
maxPrice
number 
可选
minDiscountPrice
number 
折扣价
可选
maxDiscountPrice
number 
可选
steerMaxPrice
number 
可选
建议客户零售价 = 批发价 * 2.5
steerMinPrice
number 
可选
stagingMaxPrice
number 
分期价格
可选
stagingMinPrice
number 
可选
itemList
array[object (ProductSkuItemVO) {18}] 
可选
id
integer 
可选
img
string 
可选
miniSale
integer 
最小起订量
可选
weight
integer 
重量
可选
color
string 
可选
sku
string 
可选
size
string 
可选
spec
string 
可选
price
number 
原价
可选
discountPrice
number 
折扣价
可选
discount
number 
折扣
可选
limitDiscountPrompt
string 
限购折扣提示
可选
inventory
integer 
可选
freeShipping
integer 
可选
isShareSku
boolean 
是否共享sku
可选
tieredPriceInfo
array[object (ProductTieredPriceInfo) {5}] 
可选
默认值:
new ArrayList<>()
batchSale
integer 
一包多件商品起批量
可选
customizedType
integer 
可选
定制类型 0-普通定制 1-激光定制
activityCode
array[integer]
可选
默认值:
new HashSet<>()
freeShippingAmount
number 
免邮门槛
可选
activityConfigList
array[object (SiteActivityConfigVo) {9}] 
活动配置信息
可选
activityCode
integer 
活动编码
可选
currentDate
string 
当前时间
可选
countDownTime
integer 
活动结束时间秒
可选
detailStyleConfig
object (StyleConfig) 
详情页活动配置
可选
listStyleConfig
object (StyleConfig) 
列表页活动配置
可选
sort
integer 
活动优先级
可选
endMatch
boolean 
是否结束匹配
可选
activityType
string 
可选
活动类型 特殊活动额外展示
折扣活动 展示折扣
discount
countDownLimit
integer 
显示时间限制
可选
priceRule
object (PriceRuleVo) 
价格规则
可选
rules
array[object (Rule) {3}] 
规则
可选
useOriginalPrice
boolean 
可选
是否使用原价 true 使用原价 false 使用折扣价
limitCount
integer 
sku购买限购数量
可选
limitOff
number 
限购折扣
可选
createdAt
string 
可选
attributes
array[string]
可选
colors
array[string]
可选
site
array[string]
可选
keywords
array[string]
可选
similarProducts
array[object (SiteProductVO) {39}] 
可选
spu
string 
可选
img
string 
可选
video
string 
视频链接
可选
videoCover
string 
视频封面图
可选
minPrice
number 
可选
maxPrice
number 
可选
productName
string 
可选
productNameEnUrl
string 
商品英文名Url
可选
minDiscountPrice
number 
折扣价
可选
maxDiscountPrice
number 
可选
steerMaxPrice
number 
可选
建议客户零售价 = 批发价 * 2.5
steerMinPrice
number 
可选
stagingMaxPrice
number 
分期价格
可选
stagingMinPrice
number 
可选
detailUrl
string 
可选
skuImages
string 
sku图片集合
可选
activityCode
array[integer]
活动编码列表
可选
默认值:
new HashSet<>()
activityConfigList
array[object (SiteActivityConfigVo) {9}] 
活动配置信息
可选
salesCount
integer 
销量
可选
reviewScore
number 
评价
可选
reviewNum
integer 
评论数
可选
discount
number 
折扣
可选
isSubscriptFlag
boolean 
是否显示活动角标
可选
默认值:
true
inventoryType
integer 
仓库类型
可选
默认值:
0
shipOutDays
array[string]
发货时间
可选
eventAttributionProperties
object (MapObject) 
事件属性集
可选
addList
boolean 
可选
有没有添加到刊登列表过
默认值:
false
isPublished
boolean 
是否已刊登
可选
默认值:
false
id
integer 
可选
默认值:
0
newScore
number 
新品排序分
可选
oldScore
number 
老品排序分
可选
hasOrder
boolean 
是否下单过
可选
bestSellerResult
object (BestSellerResult) 
榜单信息
可选
supplierBrandImg
string 
供应商图片透明图
可选
isCustomize
boolean 
可选
是否定制 true可以定制
isLaserCustomize
boolean 
可选
是否激光定制 true可以激光定制
minWeight
integer 
最小重量
可选
miniSale
integer 
最小起订量
可选
extraType
integer 
可选
商品扩展类型
0-普通
1-oem或爆款砍价商品
默认值:
0
categories
array[string]
可选
recStrategy
integer 
可选
默认值:
1
shield
string 
屏蔽日期
可选
isNewSize
integer 
尺码相关
可选
sizeImage
string 
可选
isShowListType
integer 
「已废弃」
可选
默认值:
0
skuShowType
integer 
可选
sku展示样式类型,SkuShowTypeEnum
默认值:
0
seos
array[object (SeoVo) {4}] 
可选
默认值:
new ArrayList<>()
rel
string 
可选
media
string 
可选
href
string 
可选
hreflang
string 
可选
supplierCodeList
array[string]
可选
inventoryType
integer 
当前库存类型
可选
默认值:
0
isSubscriptFlag
boolean 
是否显示活动角标
可选
默认值:
true
inventoryLimit
integer 
可选
库存限制
是否库存限制
默认值:
0
inventoryShow
integer 
是否展示库存
可选
默认值:
0
inventoryPrompt
string 
库存加超提示语
可选
noindex
integer 
禁止收录索引
可选
默认值:
0
inventoryList
array[object (InventoryVo) {4}] 
商品仓库列表
可选
默认值:
new ArrayList<>()
title
string 
文案
可选
inventoryType
integer 
仓库类型
可选
bubble
string 
气泡文案
可选
notice
string 
公告
可选
fitType
object (MapString) 
商品详情信息
可选
key
string 
可选
productNameEnUrl
string 
商品英文名Url
可选
offShelves
boolean 
是否下架
可选
默认值:
false
promotionAccess
boolean 
可选
是否促销接入
是否促销接入 true接入,商详加购价格,服务端计算;false不接入,保持老逻辑,还是客户端计算
默认值:
true
totalInventory
integer 
总库存数
可选
eventAttributionProperties
object (MapObject) 
事件属性集
可选
key
object (key) 
商品详情信息
可选
hasOrder
boolean 
是否下单过
可选
isCustomize
boolean 
可选
是否定制 true可以定制
customizedType
integer 
可选
定制类型 0-普通定制 1-激光定制
extraType
integer 
可选
商品拓展类型,0-普通商品,1-oem或爆款核价商品
默认值:
0
deliveryProbability
number 
到货概率
可选
deliveryAgeing
string 
到货时效
可选
supplierBrandImg
string 
供应商图片透明图
可选
addList
boolean 
是否已铺货
可选
默认值:
false
isPublished
boolean 
是否已刊登
可选
默认值:
false
buyMoreRefundDes
object (ContentVo) 
商品详情信息
可选
title
string 
可选
desc
string 
可选
benefit
string 
可选
logo
string 
可选
sort
integer 
可选
shippingDateTime
string 
可选
TODO 逻辑实现
发货日期(预售商品)
footerKeywordList
array[object (KeywordListVO) {18}] 
可选
associationId
integer 
可选
site_category_keyword_association 主键id
id
integer 
可选
site_keyword表主键id
categoryId
integer 
可选
keywordName
string 
可选
keywordUrl
string 
可选
keywordNameEscape
string 
可选
storeId
integer 
语言id
可选
language
integer 
语言id,同上
可选
sort
integer 
可选
site_category_keyword_association 表 sort字段
keywordType
integer 
关键词产品数量
可选
keywordTitle
string 
可选
keywordKeywords
string 
可选
keywordDescription
string 
可选
keywordInfo
string 
可选
newKey
boolean 
可选
siteIds
array[integer]
可选
languageAssociationId
integer 
可选
同一个关键字不用语言相关联的id,保存英语下的id
同一个关键字不同语言相关联的id,保存英语下的id
siteProductNum
object (MapInteger) 
站点下的产品数量
可选
示例
{
  "detailUrl": "",
  "url": "",
  "name": "",
  "spu": "",
  "imgList": [
    ""
  ],
  "img": "",
  "imgInfoList": [
    ""
  ],
  "video": "",
  "videoDuration": "",
  "videoImgUrl": [
    ""
  ],
  "videoCover": "",
  "salesCount": 0,
  "reviewScore": 0.0,
  "reviewNum": 0,
  "crumbs": [
    {
      "name": "",
      "url": "",
      "id": 0,
      "categroyId": 0
    }
  ],
  "bestSellerResult": {
    "mainCategoryId": 0,
    "mainCategoryName": "",
    "rank": 0,
    "rank10d": 0
  },
  "detailJson": "",
  "sizeRatioJson": "",
  "sizeRatioUnitJson": "",
  "tdk": {
    "title": "",
    "description": "",
    "keywords": "",
    "icon": "",
    "pageTitle": ""
  },
  "discount": 0.0,
  "minPrice": 0.0,
  "maxPrice": 0.0,
  "minDiscountPrice": 0.0,
  "maxDiscountPrice": 0.0,
  "steerMaxPrice": 0.0,
  "steerMinPrice": 0.0,
  "stagingMaxPrice": 0.0,
  "stagingMinPrice": 0.0,
  "itemList": [
    {
      "id": 0,
      "img": "",
      "miniSale": 0,
      "weight": 0,
      "color": "",
      "sku": "",
      "size": "",
      "spec": "",
      "price": 0.0,
      "discountPrice": 0.0,
      "discount": 0.0,
      "inventory": 0,
      "freeShipping": 0,
      "tieredPriceInfo": [
        {
          "num": 0,
          "useOriginalPrice": false,
          "title": "",
          "off": 0.0,
          "isLimit": false
        }
      ],
      "batchSale": 0
    }
  ],
  "activityCode": [
    0
  ],
  "activityConfigList": [
    {
      "activityCode": 0,
      "currentDate": "",
      "countDownTime": 0,
      "detailStyleConfig": {
        "icon": "",
        "pcW": 0,
        "pcH": 0,
        "h5W": 0,
        "h5H": 0,
        "appSize": "",
        "iconPosition": "",
        "title": "",
        "fontSize": "",
        "titleColor": "",
        "namePrefix": "",
        "namePrefixColor": "",
        "countDownColor": "",
        "countDownIcon": "",
        "showCountDown": false,
        "linkUrl": "",
        "actType": "",
        "bgType": 0,
        "bgColor": "",
        "bgImg": ""
      },
      "listStyleConfig": {
        "icon": "",
        "pcW": 0,
        "pcH": 0,
        "h5W": 0,
        "h5H": 0,
        "appSize": "",
        "iconPosition": "",
        "title": "",
        "fontSize": "",
        "titleColor": "",
        "namePrefix": "",
        "namePrefixColor": "",
        "countDownColor": "",
        "countDownIcon": "",
        "showCountDown": false,
        "linkUrl": "",
        "actType": "",
        "bgType": 0,
        "bgColor": "",
        "bgImg": ""
      },
      "sort": 0,
      "endMatch": false,
      "activityType": "",
      "countDownLimit": 0
    }
  ],
  "priceRule": {
    "rules": [
      {
        "title": "",
        "off": 0.0,
        "num": 0
      }
    ],
    "useOriginalPrice": false,
    "limitCount": 0,
    "limitOff": 0.0
  },
  "createdAt": "",
  "attributes": [
    ""
  ],
  "colors": [
    ""
  ],
  "site": [
    ""
  ],
  "keywords": [
    ""
  ],
  "similarProducts": [
    {
      "spu": "",
      "img": "",
      "video": "",
      "videoCover": "",
      "minPrice": 0.0,
      "maxPrice": 0.0,
      "productName": "",
      "productNameEnUrl": "",
      "minDiscountPrice": 0.0,
      "maxDiscountPrice": 0.0,
      "steerMaxPrice": 0.0,
      "steerMinPrice": 0.0,
      "stagingMaxPrice": 0.0,
      "stagingMinPrice": 0.0,
      "detailUrl": "",
      "skuImages": "",
      "activityCode": [
        0
      ],
      "activityConfigList": [
        {
          "activityCode": 0,
          "currentDate": "",
          "countDownTime": 0,
          "detailStyleConfig": {
            "icon": "",
            "pcW": 0,
            "pcH": 0,
            "h5W": 0,
            "h5H": 0,
            "appSize": "",
            "iconPosition": "",
            "title": "",
            "fontSize": "",
            "titleColor": "",
            "namePrefix": "",
            "namePrefixColor": "",
            "countDownColor": "",
            "countDownIcon": "",
            "showCountDown": false,
            "linkUrl": "",
            "actType": "",
            "bgType": 0,
            "bgColor": "",
            "bgImg": ""
          },
          "listStyleConfig": {
            "icon": "",
            "pcW": 0,
            "pcH": 0,
            "h5W": 0,
            "h5H": 0,
            "appSize": "",
            "iconPosition": "",
            "title": "",
            "fontSize": "",
            "titleColor": "",
            "namePrefix": "",
            "namePrefixColor": "",
            "countDownColor": "",
            "countDownIcon": "",
            "showCountDown": false,
            "linkUrl": "",
            "actType": "",
            "bgType": 0,
            "bgColor": "",
            "bgImg": ""
          },
          "sort": 0,
          "endMatch": false,
          "activityType": "",
          "countDownLimit": 0
        }
      ],
      "salesCount": 0,
      "reviewScore": 0.0,
      "reviewNum": 0,
      "discount": 0.0,
      "isSubscriptFlag": false,
      "inventoryType": 0,
      "shipOutDays": [
        ""
      ],
      "eventAttributionProperties": {
        "": {}
      },
      "addList": false,
      "isPublished": false,
      "id": 0,
      "newScore": 0.0,
      "oldScore": 0.0,
      "hasOrder": false,
      "bestSellerResult": {
        "mainCategoryId": 0,
        "mainCategoryName": "",
        "rank": 0,
        "rank10d": 0
      },
      "supplierBrandImg": "",
      "isCustomize": false,
      "minWeight": 0
    }
  ],
  "categories": [
    ""
  ],
  "recStrategy": 0,
  "shield": "",
  "isNewSize": 0,
  "sizeImage": "",
  "isShowListType": 0,
  "skuShowType": 0,
  "seos": [
    {
      "rel": "",
      "media": "",
      "href": "",
      "hreflang": ""
    }
  ],
  "supplierCodeList": [
    ""
  ],
  "inventoryType": 0,
  "isSubscriptFlag": false,
  "inventoryLimit": 0,
  "inventoryShow": 0,
  "inventoryPrompt": "",
  "noindex": 0,
  "inventoryList": [
    {
      "title": "",
      "inventoryType": 0,
      "bubble": "",
      "notice": ""
    }
  ],
  "fitType": {
    "": ""
  },
  "productNameEnUrl": "",
  "offShelves": false,
  "promotionAccess": false,
  "totalInventory": 0,
  "eventAttributionProperties": {
    "": {}
  },
  "hasOrder": false,
  "isCustomize": false,
  "extraType": 0,
  "deliveryProbability": 0.0,
  "deliveryAgeing": "",
  "supplierBrandImg": "",
  "addList": false,
  "isPublished": false,
  "buyMoreRefundDes": {
    "title": "",
    "desc": "",
    "benefit": "",
    "logo": "",
    "sort": 0
  },
  "footerKeywordList": [
    {
      "associationId": 0,
      "id": 0,
      "categoryId": 0,
      "keywordName": "",
      "keywordUrl": "",
      "keywordNameEscape": "",
      "storeId": 0,
      "language": 0,
      "sort": 0,
      "keywordType": 0,
      "keywordTitle": "",
      "keywordKeywords": "",
      "keywordDescription": "",
      "keywordInfo": "",
      "newKey": false,
      "siteIds": [
        0
      ],
      "languageAssociationId": 0,
      "siteProductNum": {
        "0": 0
      }
    }
  ]
}
修改于 2025-05-19 07:24:22
上一页
设置log
下一页
计算商详sku价格
Built with