1.SPU 基础详情

get /mobile/shop/shop-product-detail/base

请求参数：

export interface Request {
    /**
     * 商品 SPU 编号
     */
    product_id: number;
    [property: string]: any;
}

返回响应：

/**
 * BaseResponse
 */
export interface Response {
    /**
     * 状态码,200=成功
     */
    code?: number;
    data?: BaseData;
    /**
     * 提示消息
     */
    msg?: string;
    /**
     * 同 code
     */
    status?: number;
    [property: string]: any;
}

/**
 * BaseData，SPU 基础详情
 */
export interface BaseData {
    item_row?: SpuItemRow;
    /**
     * SPU 级商品描述(可能为空数组)
     */
    product_detail?: SpuDetailRow[];
    /**
     * 商品 SPU 编号
     */
    product_id?: number;
    [property: string]: any;
}

/**
 * SpuItemRow，SPU 基础字段(ShopProductBase + ShopProductIndex 合并)。注:教育课程商品(kind_id=1205)的
 * course/product_tag_names 字段不在本接口,课程类商品仍走老接口。
 */
export interface SpuItemRow {
    /**
     * 描述展示方式(控制 SKU 级描述置换)
     */
    all_spec_show?: number;
    /**
     * 类目编号
     */
    category_id?: number;
    /**
     * 最末级类目名
     */
    category_name?: string;
    /**
     * 描述模板
     */
    description_template?: string;
    /**
     * 零售开关
     */
    enable_retail?: number;
    /**
     * 批发开关
     */
    enable_wholesale?: number;
    /**
     * 通用描述
     */
    general_detail?: string;
    /**
     * 是否连锁(非虚拟为 1)
     */
    is_chain?: number;
    /**
     * 是否虚拟商品(服务/卡券/教育/电费/售后类为 1)
     */
    is_virtual?: number;
    /**
     * 商品类型(1201 实体/1202 服务/...)
     */
    kind_id?: number;
    /**
     * 最小起订量
     */
    min_order_quantity?: number;
    /**
     * 阶梯定价类型
     */
    pricing_tier_type?: number;
    /**
     * 佣金比例
     */
    product_commission_rate?: number;
    /**
     * 成本价
     */
    product_cost_price?: number;
    /**
     * 产地
     */
    product_country?: string;
    /**
     * 币种
     */
    product_currency?: string;
    /**
     * 经销商开关
     */
    product_dist_enable?: number;
    /**
     * 商品来源
     */
    product_from?: string;
    /**
     * 分销开关
     */
    product_fx_enable?: number;
    /**
     * SPU 编号
     */
    product_id?: number;
    /**
     * SPU 主图
     */
    product_image?: string;
    /**
     * 库存锁定标记
     */
    product_inventory_lock?: number;
    /**
     * 是否二手
     */
    product_is_used?: number;
    /**
     * 市场价
     */
    product_market_price?: number;
    /**
     * 市场价区间-最高
     */
    product_market_price_max?: number;
    /**
     * 市场价区间-最低
     */
    product_market_price_min?: number;
    /**
     * 商品名
     */
    product_name?: string;
    /**
     * 商品编码
     */
    product_number?: string;
    /**
     * 价格区间-最高
     */
    product_price_max?: number;
    /**
     * 价格区间-最低
     */
    product_price_min?: number;
    /**
     * SPU 状态(2001=无货可预订等)
     */
    product_state_id?: number;
    /**
     * 标签 id 集合
     */
    product_tags?: string;
    /**
     * 商品副标题
     */
    product_tips?: string;
    /**
     * 积分价
     */
    product_unit_points?: number;
    /**
     * 单价
     */
    product_unit_price?: number;
    /**
     * 最高单价
     */
    product_unit_price_max?: number;
    /**
     * 主图视频
     */
    product_video?: string;
    /**
     * 补货提示数量
     */
    restock_count?: number;
    /**
     * 店铺编号
     */
    store_id?: number;
    /**
     * 是否自营
     */
    store_is_selfsupport?: number;
    /**
     * 店铺名
     */
    store_name?: string;
    /**
     * 是否支持混批
     */
    support_batch_mix?: number;
    /**
     * 运费模板编号
     */
    transport_type_id?: number;
    /**
     * 计量单位编号
     */
    unit_id?: number;
    /**
     * 单位名(中文)
     */
    unit_name?: string;
    /**
     * 单位名(英文单数)
     */
    unit_name_en?: string;
    /**
     * 单位名(英文复数)
     */
    unit_name_en_plural?: string;
    [property: string]: any;
}

/**
 * SpuDetailRow，SPU 描述行
 */
export interface SpuDetailRow {
    /**
     * 加购数量,固定 1
     */
    add_num?: number;
    /**
     * 固定 1,标识 SPU 级描述
     */
    is_spu?: number;
    /**
     * SPU 状态(取 product_state_id)
     */
    item_enable?: number;
    /**
     * 商品主图
     */
    item_image?: string;
    /**
     * 商品单价(SPU 起售价)
     */
    item_price?: number;
    /**
     * 商品名
     */
    proName?: string;
    /**
     * 补货提示数量
     */
    restock_count?: number;
    /**
     * 描述内容(富文本)
     */
    sku_detail?: string;
    [property: string]: any;
}

2.SPU 媒体图片

get /mobile/shop/shop-product-detail/media

请求参数：

export interface Request {
    /**
     * 商品 SPU 编号
     */
    product_id: number;
    [property: string]: any;
}

返回响应：

/**
 * MediaResponse
 */
export interface Response {
    /**
     * 状态码,200=成功
     */
    code?: number;
    data?: MediaData;
    /**
     * 提示消息
     */
    msg?: string;
    /**
     * 同 code
     */
    status?: number;
    [property: string]: any;
}

/**
 * MediaData，SPU 媒体图片
 */
export interface MediaData {
    /**
     * 图片 URL → SKU 编号映射。仅 NORMAL(上架)态 SKU 参与,某颜色匹配的上架 SKU 数≠1 时 value 为 0
     */
    image_spec_value_map?: { [key: string]: number };
    /**
     * 详情页图集:SPU 图库在前 + 当前颜色规格图在后,不足 5 张用其它颜色规格图补全
     */
    item_image_row?: string[];
    /**
     * 商品 SPU 编号
     */
    product_id?: number;
    /**
     * 展示主图。优先级:SPU 图库首图 → 当前颜色主图 → SPU 主图字段
     */
    product_image?: string;
    /**
     * SKU 总数
     */
    skuItemCounts?: number;
    /**
     * SKU 顶部精简列表(NORMAL+OFF_SHELF 态)
     */
    skuTopList?: SkuTopRow[];
    /**
     * 当前颜色(color_id)的规格图列表
     */
    specImages?: string[];
    [property: string]: any;
}

/**
 * SkuTopRow，SKU 精简展示行
 */
export interface SkuTopRow {
    /**
     * 默认规格标记(固定取 item_is_default,非"当前选中"语义)
     */
    isSelect?: number;
    /**
     * SKU 状态
     */
    item_enable?: number;
    /**
     * SKU 编号
     */
    item_id?: number;
    /**
     * 库存
     */
    item_quantity?: number;
    /**
     * 该颜色的规格图
     */
    product_image?: string;
    /**
     * 规格名(如 "红色,XL"),非中文环境走翻译
     */
    skuItemStr?: string;
    [property: string]: any;
}

3.SPU 下所有 SKU 列表与规格项

get /mobile/shop/shop-product-detail/skus

请求参数:

export interface Request {
    /**
     * 商品 SPU 编号
     */
    product_id: number;
    [property: string]: any;
}

返回响应:

/**
 * SkusResponse
 */
export interface Response {
    /**
     * 状态码,200=成功
     */
    code?: number;
    data?: SkusData;
    /**
     * 提示消息
     */
    msg?: string;
    /**
     * 同 code
     */
    status?: number;
    [property: string]: any;
}

/**
 * SkusData，SPU 下 SKU 列表与规格项
 */
export interface SkusData {
    /**
     * 全部 NORMAL+OFF_SHELF 态 SKU
     */
    allSkuList?: DetailProductSkuDTO[];
    /**
     * 商品 SPU 编号
     */
    product_id?: number;
    /**
     * 规格项分组,默认 SKU 的规格值 isActive=true
     */
    properties?: SpecGroupDTO[];
    [property: string]: any;
}

/**
 * DetailProductSkuDTO，SKU 结构
 */
export interface DetailProductSkuDTO {
    /**
     * 规格值 id 集合(spec_item_ids 逗号拆分)
     */
    attributes?: number[];
    /**
     * SKU 编号
     */
    id?: number;
    /**
     * SKU 状态
     */
    item_enable?: number;
    /**
     * SKU 单价
     */
    price?: number;
    /**
     * 可售库存(item_quantity - item_quantity_frozen,负数归零)
     */
    stock?: number;
    [property: string]: any;
}

/**
 * SpecGroupDTO，规格项分组
 */
export interface SpecGroupDTO {
    /**
     * 属性值列表
     */
    attributes?: SpecItemDTO[];
    /**
     * 规格名称
     */
    name?: string;
    /**
     * 规格 id(如"颜色")
     */
    specId?: number;
    [property: string]: any;
}

/**
 * SpecItemDTO，属性值
 */
export interface SpecItemDTO {
    /**
     * 是否默认 SKU 的规格值
     */
    isActive?: boolean;
    /**
     * 属性值 id
     */
    itemId?: number;
    /**
     * 属性值名称(如"绿色")
     */
    label?: string;
    /**
     * 同 label
     */
    value?: string;
    [property: string]: any;
}

4.SPU 互动数据

get /mobile/shop/shop-product-detail/interaction

请求参数:

export interface Request {
    /**
     * 1=加载最新 5 条评论，其它=不加载
     */
    comment_flag?: number;
    /**
     * 商品 SPU 编号
     */
    product_id: number;
    [property: string]: any;
}

返回响应:

/**
 * InteractionResponse
 */
export interface Response {
    /**
     * 状态码,200=成功
     */
    code?: number;
    data?: InteractionData;
    /**
     * 提示消息
     */
    msg?: string;
    /**
     * 同 code
     */
    status?: number;
    [property: string]: any;
}

/**
 * InteractionData，SPU 互动数据
 */
export interface InteractionData {
    /**
     * 最新一条评论(comment_flag=1 且有评论时返回,否则为空数组)
     */
    last_comment_row?: CommentRow;
    /**
     * 最新 5 条评论(comment_flag=1 时返回)
     */
    last_comment_rows?: CommentRow[];
    /**
     * 商品 SPU 编号
     */
    product_id?: number;
    /**
     * SPU 维度平均评分(1 位小数),无评价为空串
     */
    product_rating?: string;
    /**
     * 关联推荐类型:0-无 1-商品 2-配件 3-商品+配件(仅统计可售关联商品并按 type 去重)
     */
    relationType?: number;
    [property: string]: any;
}

/**
 * 最新一条评论(comment_flag=1 且有评论时返回,否则为空数组)
 *
 * CommentRow，评论行(shop_product_comment 表字段 + 补全字段)
 */
export interface CommentRow {
    /**
     * 评论内容
     */
    comment_content?: string;
    /**
     * 评论编号
     */
    comment_id?: number;
    /**
     * 评分(1-5)
     */
    comment_scores?: number;
    /**
     * 评论时间。中文环境 yyyy-MM-dd HH:mm:ss;非中文环境 "MMM d,yyyy"(如 May 4,2026)
     */
    comment_time?: string;
    /**
     * 评论所属 SKU 编号
     */
    item_id?: number;
    /**
     * 评论所属 SKU 规格名(如"红色,XL",非中文环境走翻译,仅 last_comment_row 有)
     */
    item_spec?: string;
    /**
     * 评论用户头像(fixUserAvatar 补全)
     */
    user_avatar?: string;
    /**
     * 评论用户编号
     */
    user_id?: number;
    /**
     * 评论用户昵称(fixUserAvatar 补全)
     */
    user_nickname?: string;
    /**
     * 公开点赞数(Redis Set 实时计数,仅 last_comment_row 有)
     */
    voteNum?: number;
    [property: string]: any;
}

5.SPU 店铺与客服

get /mobile/shop/shop-product-detail/store

请求参数:

export interface Request {
    /**
     * 商品 SPU 编号
     */
    product_id: number;
    [property: string]: any;
}

返回响应:

/**
 * StoreResponse
 */
export interface Response {
    /**
     * 状态码,200=成功
     */
    code?: number;
    data?: StoreData;
    /**
     * 提示消息
     */
    msg?: string;
    /**
     * 同 code
     */
    status?: number;
    [property: string]: any;
}

/**
 * StoreData，SPU 店铺与客服
 */
export interface StoreData {
    /**
     * 店铺合同类型列表(消费者服务关联)
     */
    contractlist?: { [key: string]: any }[];
    /**
     * 多店铺开关
     */
    multishop_enable?: number;
    /**
     * 商品 SPU 编号
     */
    product_id?: number;
    store_info?: StoreInfo;
    /**
     * 店主用户编号
     */
    store_owner_user_id?: number;
    /**
     * 店主用户详情(头像/手机号等 AccountUserInfo 结构)
     */
    user_info?: { [key: string]: any };
    [property: string]: any;
}

/**
 * StoreInfo，店铺信息(shop_store_base + shop_store_analytics + shop_store_info 合并)
 */
export interface StoreInfo {
    /**
     * 店铺客服列表(enable=1)
     */
    custom_service_rows?: { [key: string]: any }[];
    /**
     * im 客服开关(im_enable 配置)
     */
    im_chat?: number;
    /**
     * 营业结束时间
     */
    store_close_hours?: string;
    /**
     * 评价数(analytics)
     */
    store_evaluation_num?: number;
    /**
     * 好评率(servicecredit/evaluation_num,保留 2 位)
     */
    store_evaluation_rate?: number;
    /**
     * 店铺编号
     */
    store_id?: number;
    /**
     * 店铺 logo
     */
    store_logo?: string;
    /**
     * 店铺名(非中文环境走翻译)
     */
    store_name?: string;
    /**
     * 营业开始时间
     */
    store_opening_hours?: string;
    /**
     * 店铺服务说明
     */
    store_service?: string;
    /**
     * 服务积分(analytics)
     */
    store_servicecredit?: number;
    /**
     * 店铺状态
     */
    store_state_id?: number;
    /**
     * 店主用户编号
     */
    user_id?: number;
    /**
     * 店主手机号
     */
    user_mobile?: string;
    [property: string]: any;
}

6.SKU 价格与库存

get /mobile/shop/shop-product-detail/sku

请求参数:

export interface Request {
    /**
     * 用户选择区域编号,传入时按该区域实时计算配送信息,不传用默认区域
     */
    district_id?: number;
    /**
     * 拼团活动编号,命中拼团活动时传入,用于返回团人数/结束时间
     */
    gb_id?: number;
    /**
     * 商品 SKU 编号
     */
    item_id: number;
    [property: string]: any;
}

返回响应:

/**
 * SkuResponse
 */
export interface Response {
    /**
     * 状态码,200=成功
     */
    code?: number;
    data?: SkuData;
    /**
     * 提示消息
     */
    msg?: string;
    /**
     * 同 code
     */
    status?: number;
    [property: string]: any;
}

/**
 * SkuData，SKU 价格与库存(复用老接口 detail() 字段提取)
 */
export interface SkuData {
    /**
     * 活动描述
     */
    activity_desc?: string;
    /**
     * 活动差价
     */
    activity_diff_price?: number;
    /**
     * 活动编号(无活动不返回)
     */
    activity_id?: number;
    /**
     * 活动前 SKU 价
     */
    activity_item_old_price?: number;
    /**
     * 活动行(含活动价/限购等;命中拼团且传 gb_id 时含 gb_amount_quantity/gb_endtime)
     */
    activity_item_row?: { [key: string]: any };
    /**
     * 活动前价格
     */
    activity_old_price?: number;
    /**
     * 活动限购数量
     */
    activity_quantity?: number;
    /**
     * 活动类型 id(如拼团 GROUPBOOKING)
     */
    activity_type_id?: number;
    /**
     * 活动类型名
     */
    activity_type_name?: string;
    /**
     * 品牌名
     */
    brand_name?: string;
    /**
     * 优惠折叠行
     */
    fold_rows?: { [key: string]: any }[];
    /**
     * 拼团成团人数(仅传 gb_id 且当前 SKU 命中拼团活动时返回)
     */
    gb_amount_quantity?: number;
    /**
     * 拼团结束时间戳(仅传 gb_id 且当前 SKU 命中拼团活动时返回)
     */
    gb_endtime?: number;
    /**
     * 赠品行
     */
    gift_rows?: { [key: string]: any }[];
    /**
     * 福袋活动数据
     */
    giftbag_item_data?: { [key: string]: any };
    /**
     * SKU 编号(顶层注入,用于缓存校验)
     */
    item_id?: number;
    item_row?: SkuItemRow;
    /**
     * 当前 SKU 阶梯价策略
     */
    itemPricePolicy?: { [key: string]: any };
    /**
     * 一件折活动数据
     */
    one_piece_discount?: { [key: string]: any };
    /**
     * 优惠套餐行
     */
    package_item_rows?: { [key: string]: any }[];
    /**
     * 辅助属性(如"糖度/酸度")展示行
     */
    product_assist_index_rows?: { [key: string]: any }[];
    /**
     * 合并版商品描述:SPU 描述 + 当前 SKU 描述(按 all_spec_show 控制,含 2001 无货可预订状态置换),切换规格时更新
     */
    product_detail?: { [key: string]: any }[];
    /**
     * 运费/配送信息。传 district_id 时按该区域实时重算;不传用默认区域
     */
    product_freight_info?: { [key: string]: any };
    /**
     * SPU 编号(顶层注入)
     */
    product_id?: number;
    /**
     * 规格组合 → SKU 映射(前端加购校验用)
     */
    product_uniqid?: { [key: string]: any };
    /**
     * 满减活动数据
     */
    reduction_item_data?: { [key: string]: any };
    /**
     * 满减规则
     */
    reduction_rule?: string;
    /**
     * 秒杀活动数据
     */
    seconds_kill_data?: { [key: string]: any };
    /**
     * 划线价展示标记:0-不展示 1-展示(秒杀或店铺开启划线价任一命中)
     */
    strikethrough_price_flag?: number;
    /**
     * 是否支持物流配送。条件字段:仅店铺在物流商户黑名单时返回(值
     * false),其余情况无此键;有效期字段(product_valid_period/product_validity_start 等)在 item_row 内展开
     */
    supportDelivery?: boolean;
    /**
     * 批发价策略列表
     */
    wholesale_policy_rows?: { [key: string]: any }[];
    [property: string]: any;
}

/**
 * SkuItemRow，当前 SKU 合并行(老接口 item_row 原样,SKU+SPU+Info+Detail 四表合并,关键字段如下,另含
 * analytics_row/contractlist/relationType/category_name 等)
 */
export interface SkuItemRow {
    /**
     * 限购数量
     */
    buy_limit?: number;
    /**
     * 颜色规格值 id
     */
    color_id?: number;
    /**
     * SKU 状态
     */
    item_enable?: number;
    /**
     * SKU 编号
     */
    item_id?: number;
    /**
     * SKU 主图
     */
    item_image_default?: string;
    /**
     * 图集(SPU 图库 + 当前颜色图)
     */
    item_image_row?: string[];
    /**
     * SKU 市场价
     */
    item_market_price?: number;
    /**
     * SKU 规格名(如"红色,XL")
     */
    item_name?: string;
    /**
     * 库存
     */
    item_quantity?: number;
    /**
     * 冻结库存
     */
    item_quantity_frozen?: number;
    /**
     * 实际售价(活动价优先)
     */
    item_sale_price?: number;
    /**
     * 规格值数组(已从 JSON 字符串解析)
     */
    item_spec?: any[];
    /**
     * SKU 单价
     */
    item_unit_price?: number;
    /**
     * SPU 编号
     */
    product_id?: number;
    /**
     * 商品名(SKU 配置了 sku_title 时被覆盖为标题)
     */
    product_name?: string;
    /**
     * SPU 规格信息(已解析)
     */
    product_spec?: { [key: string]: any };
    /**
     * SPU 状态(实时二次注入)
     */
    product_state_id?: number;
    /**
     * 规格组合唯一键
     */
    product_uniqid?: string;
    /**
     * 规格值 id 集合(逗号分隔)
     */
    spec_item_ids?: string;
    /**
     * 店铺编号
     */
    store_id?: number;
    [property: string]: any;
}

7.当前用户在该商品详情页的私有状态

get /mobile/shop/shop-product-detail/user-state

请求参数:

export interface Request {
    /**
     * 商品 SKU 编号
     */
    item_id: number;
    /**
     * 店铺编号
     */
    store_id?: number;
    [property: string]: any;
}

返回响应:

/**
 * UserStateResponse
 */
export interface Response {
    /**
     * 状态码,200=成功
     */
    code?: number;
    data?: UserStateData;
    /**
     * 提示消息
     */
    msg?: string;
    /**
     * 同 code
     */
    status?: number;
    [property: string]: any;
}

/**
 * UserStateData，用户态字段(未登录全部为 0)
 */
export interface UserStateData {
    /**
     * 收藏记录编号(未收藏为 0)
     */
    favorites_item_id?: number;
    /**
     * 是否收藏当前 SKU:0/1
     */
    is_favorite?: number;
    /**
     * 是否购买过(当前固定 0,与老接口保持兼容)
     */
    is_had_bought?: number;
    /**
     * 当前用户是否店铺主:0/1(需传 store_id)
     */
    is_store_owner?: number;
    /**
     * 是否收藏店铺:0/1(需传 store_id)
     */
    store_collect?: number;
    /**
     * 是否分销合伙人:0/1
     */
    user_is_pt?: number;
    [property: string]: any;
}