小鹅通 · 云服务 API
首页
解决方案
  • 开放API
  • APP开店
文档中心应用市场控制台
首页
解决方案
  • 开放API
  • APP开店
文档中心应用市场控制台
  1. 商品管理
  • 开发前必读
    • 小鹅云介绍
    • 更新日志
    • 开始开发
    • 小鹅通开放API开发交流群
  • 开发指南
    • 创建并授权应用
    • 获取access_token(含代码示例)
    • 开通接口权限
    • 全局返回码
    • 常用工具
      • 日志排查工具
  • 场景方案
    • 同步用户场景
    • 同步商品场景
    • 同步订购关系场景
    • 同步积分场景
    • 同步页面统计场景
    • 同步学习数据场景
    • 同步推广员场景
  • 内嵌SDK服务场景
    • 产品简介
    • 小鹅通SDK开发者声明
    • 小鹅通SDK个人信息保护政策
    • 开发指南
    • Android-SDK 接入
    • iOS-SDK 接入
    • H5直接嵌入
    • SDK&H5账号详解
    • 常见问题
    • 原生SDK登录态
      • 先决条件
      • 登录接口
      • 登出接口
  • 消息推送
    • 使用说明
    • 消息加/解密
    • 消息接收URL校验说明
    • 账号合并推送
    • 用户手机号变更推送
    • 用户状态变更推送
    • 用户注册推送
    • 商品变更推送
    • 订单支付推送
    • 订单状态变更推送
    • 优惠券消息推送
    • 信息采集推送
    • 积分变更推送
    • 考试消息推送
    • 活动签到推送
  • API列表
    • 用户管理
      • 使用说明
      • 注册新用户
      • 更新用户信息
      • 获取用户列表2.0
      • 获取用户列表1.0.0
      • 查询单个用户信息
      • 批量查询获取用户信息
      • 获取用户消费信息
      • 获取课程学员列表
      • 查询单个用户标签列表
      • 查询用户合并记录
      • 获取标签列表
      • 添加/修改标签
      • 添加/修改用户标签
    • 学习数据管理
      • 获取学习记录列表
      • 获取每日学习记录
      • 获取指定资源学习记录信息
      • 获取营期下用户的学习情况
    • 直播管理
      • 获取直播列表
      • 获取班课列表接口
      • 获取签到列表
      • 获取签到学员列表
      • 获取直播红包列表
      • 获取红包领取记录
      • 获取直播数据概览
      • 获取直播详情
      • 获取红包数据概况
    • 商品管理
      • 查询商品列表2.0
        POST
      • 查询商品列表1.0
        POST
      • 拉取组合课的资源列表4.0
        POST
      • 拉取组合课的资源列表3.0
        POST
      • 获取训练营营期任务
        POST
      • 商品详情2.0
        POST
      • 商品详情1.0
        POST
      • 获取直播带货商品列表
        POST
      • 商品增加库存
        POST
      • 商品减少库存
        POST
      • 新建实物商品
        POST
      • 编辑实物商品
        POST
      • 删除实物商品
        POST
      • 获取实物商品列表
        POST
      • 获取C端搜索商品列表
        POST
    • 商品分组管理
      • 获取店铺商品分组列表
      • 获取商品分组内商品列表
      • 批量新建/更新商品分组
      • 删除商品分组
    • 素材管理
      • 获取素材列表
      • 获取素材分组列表
      • 素材分组编辑
      • 素材分组移动
      • 素材分组删除
    • 订单管理
      • 获取订单列表1.1
      • 获取订单列表1.0
      • 查询用户订单列表
      • 获取订单详情
    • 订购管理
      • 用户开通产品包权益
      • 查询用户订购资源列表
      • 用户购买关系查询
      • 查询用户资源权益2.0
      • 查询用户资源权益1.0
      • 取消订购
    • 物流管理
      • 普通实物单发货
    • 推广员管理
      • 查询推广员列表
      • 查询推广员客户列表
      • 查询推广员的下级推广员列表
      • 查询指定推广员的信息
      • 查询客户所属推广员
      • 新增推广员
      • 推广员绑定客户
      • 修改/解除绑定关系
      • 设置推广员上级
      • 推广订单详情
      • 按日期查询推广员的收益和新增加的下级
      • 推广订单详情(支持购物车订单返回多条记录)
    • 信息采集管理
      • 获取信息采集列表
      • 获取单个信息采集结果
      • 获取用户信息采集结果
      • 根据表单ID以及用户ID获取信息采集结果
    • 营销码卷管理
      • 优惠券列表
      • 获取优惠券详情2.0
      • 获取优惠券详情
      • 获取优惠券领券用户
      • 发放优惠券2.0
      • 发放优惠券
      • 优惠券核销
      • 获取优惠码列表
      • 获取优惠码码库列表
      • 获取优惠码效果数据
      • 创建优惠码
      • 优惠码添加库存
      • 优惠码失效
      • 编辑优惠码
      • 优惠码删除
      • 获取兑换码码库列表
      • 追加兑换码库存
      • 创建兑换码
      • 编辑兑换码
      • 兑换码失效
      • 用户使用兑换码
      • 获取兑换码批次列表
    • 积分管理
      • 业务类型说明
      • 查询用户积分日志
      • 获取单个用户积分信息
      • 批量获取用户积分列表
      • 获取店铺积分信息
      • 批量发放积分
      • 批量扣减积分
      • 解冻冻结积分
      • 设置店铺积分过期时间
    • 页面统计管理
      • 新建页面统计
      • 编辑页面统计
      • 获取页面统计列表
      • 获取页面统计详情
      • 获取页面统计订单列表
      • 新建投放渠道
      • 获取投放渠道列表
    • 打卡管理
      • 获取打卡列表
      • 获取打卡参与用户
      • 获取指定学员活动日记列表
      • 获取活动点赞列表
      • 获取指定学员被点赞总数和列表
      • 获取用户日记被点评/评论列表
    • 社群管理
      • 获取用户参与的小社群
    • 考试管理
      • 获取考试列表
      • 获取考试详情
      • 获取考试结果列表信息
      • 获取考试结果详细信息
    • 活动管理
      • 获取活动列表
      • 获取签到列表
      • 获取活动报名列表
      • 获取活动签到信息
    • 组织管理
      • 获取员工列表
      • 获取员工详细信息
      • 添加或者保存员工信息
      • 启用员工
      • 停用员工
      • 删除员工
      • 根据员工账号获取用户ID
      • 获取组织结构树
      • 添加或修改组织架构
      • 移除组织架构
    • 微页面管理
      • 获取微页面列表
    • 企学院专用
      • 学员管理
        • 企学院获取学员列表
        • 企学院添加学员
        • 企学院修改学员
        • 企学院删除学员
        • 企学院添加组织架构
        • 企学院删除组织架构
        • 企学院编辑组织架构
        • 企学院获取组织架构
        • 企学院获取部门信息
      • 活动管理
        • 企学院用户签到活动列表
      • 培训计划管理(限企学院)
        • 获取培训计划列表
        • 获取培训计划详情
        • 获取用户培训学习数据
        • 获取员工的培训计划列表
  • 旧版API
    • 使用须知
    • 旧版指南
      • 签名和请求
      • Xiaoe SDK使用简介
      • 状态码和常见问题
    • 用户
      • 用户注册
      • 用户信息修改
      • 获取用户信息
    • 支付
      • 下单
      • 更新订单状态
    • 订单
      • 订单查询1.0
      • 订单查询2.0
    • 订购
      • 订阅列表查询
      • 订阅用户列表查询
      • 取消订阅
  • 常见问题
    • 问题汇总
    • 问题反馈
  1. 商品管理

商品详情2.0

POST
https://api.xiaoe-tech.com/xe.goods.detail.get/4.0.0
拥有此API的权限集
商品管理-查询商品信息
备注
resource_type资源类型有:1-图文,2-音频,3-视频,4-直播,5-会员,6-专栏,7-小社群,8-大专栏,9-活动管理,16-付费打卡,20-电子书,21-实物商品,23-超级会员,25-训练营,29-线下课,31-小班课,34-练习,35-班课,37-大班课,41-有价优惠券,42-课时包,45-AI互动课,46-付费问答,47-付费问答-答主,50-鹅课程
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.xiaoe-tech.com/xe.goods.detail.get/4.0.0' \
--header 'Content-Type: application/json' \
--data-raw '{
    "access_token": "xe_xxxx",
    "resources":[
        {
            "type":2,
            "ids":[
                "a_619fba7ae4b03f3fb99c7809"
            ]
        }
    ],
    "body":"stock,sku,attr"
}'
响应示例响应示例
{
  "code": 0,
  "msg": "success",
  "data": [
    {
      "app_id": "appxxxx",
      "appraise_num": 0,
      "attach_count": 0,
      "attr": [],
      "can_sold_end": "0000-00-00 00:00:00",
      "can_sold_start": "0000-00-00 00:00:00",
      "created_at": "2021-11-26 00:31:54",
      "custom_cover": "",
      "distribution_pattern": 1,
      "extend": {
        "sell_num": 2,
        "stock": 999999997
      },
      "freight": 0,
      "freight_template_id": 0,
      "goods_brief_text": "",
      "goods_category_id": "",
      "goods_detail_text": "",
      "goods_img": [
        "https://wechatapppro-1252524126.file.myqcloud.com/appAKLWLitn7978/image/b_u_5b2225aa46488_oGKN7IvA/kwes0kzk0hhw.png"
      ],
      "goods_name": "呜呜",
      "goods_tag": "",
      "goods_tag_is_show": 1,
      "has_distribute": 1,
      "id": 3458475,
      "img_url_compressed": "https://wechatapppro-1252524126.file.myqcloud.com/appAKLWLitn7978/image/b_u_5b2225aa46488_oGKN7IvA/kwes0kzk0hhw.png",
      "is_best": 0,
      "is_deleted": 0,
      "is_display": 1,
      "is_forbid": 0,
      "is_free": 0,
      "is_goods_package": 0,
      "is_hot": 0,
      "is_ignore": 0,
      "is_new": 0,
      "is_password": 0,
      "is_public": 1,
      "is_recom": 0,
      "is_single": 1,
      "is_stop_sell": 0,
      "is_timing_sale": 1,
      "is_uniform_freight": 1,
      "limit_purchase": 0,
      "period": -1,
      "period_type": 0,
      "period_value": "0",
      "price_high": 2,
      "price_line": 0,
      "price_low": 2,
      "pv": 2,
      "resource_id": "a_619fba7ae4b03f3fb99c7809",
      "resource_type": 2,
      "sale_at": "2021-11-30 00:36:01",
      "sale_status": 1,
      "sell_mode": 1,
      "sell_type": 1,
      "show_stock": 0,
      "sku": [
        {
          "attr_data": [],
          "is_default": 1,
          "is_deleted": 0,
          "is_free": 0,
          "limit_purchase": 0,
          "limit_purchase_type": 0,
          "order_stock_limit": 0,
          "period_type": 0,
          "period_value": "0",
          "sku_business_id": "",
          "sku_desc": "",
          "sku_id": "SKU_ADO_6378579149295pIEPP38",
          "sku_img": "https://wechatapppro-1252524126.file.myqcloud.com/appAKLWLitn7978/image/b_u_5b2225aa46488_oGKN7IvA/kwes0kzk0hhw.png",
          "sku_line_price": 0,
          "sku_min_purchase": 0,
          "sku_name": "呜呜",
          "sku_price": 2,
          "state": 1,
          "value_count": 0
        }
      ],
      "spu_id": "a_619fba7ae4b03f3fb99c7809",
      "spu_type": "ADO",
      "stock": [
        {
          "is_deleted": 0,
          "left_num": 999999997,
          "remark": "",
          "sell_num": 2,
          "setting_stock": 999999997,
          "sku_id": "SKU_ADO_6378579149295pIEPP38"
        }
      ],
      "stock_deduct_mode": 0,
      "timing_sale": "2021-11-30 00:36:00",
      "updated_at": "2021-11-30 00:36:01",
      "uv": 1,
      "video_img_url": "",
      "video_url": "",
      "visit_num": 2,
      "wx_goods_category_id": ""
    }
  ]
}

请求参数

Body 参数application/json
access_token
string 
专属token
必需
resources
array [object {2}] 
必需
type
integer 
资源类型
必需
ids
array[string]
资源ID集合
必需
body
string 
可选
传“stock”查询库存信息,传sku查sku相关信息,传attr查属性相关信息,不传则不查附属信息
is_return_deleted
string 
可选
是否删除 0正常 1已删除 不传默认返回所有数据
is_return_forbid
string 
可选
商品是否被封禁:0 = 否,1 = 是 不传默认返回所有数据
is_cache
string 
可选
是否查询缓存:false = 否,true = 是 默认是
示例

返回响应

🟢200成功
application/json
Body
code
integer 
必需
状态码(0为请求成功,其它为请求失败)
msg
string 
请求状态描述信息
必需
data
array [object {70}] 
返回数据
必需
app_id
string 
店铺ID
可选
goods_sn
string 
商品编码
可选
sku_cost_price
object 
sku成本价
可选
sku_volume
string 
sku体积
可选
sku_spec_code
string 
sku规格编码
可选
sku_weight
string 
sku重量
可选
appraise_num
integer 
评价数
可选
attach_count
integer 
带货的数量
可选
attr
array[string]
属性信息
可选
can_sold_end
string 
可售结束时间
可选
can_sold_start
string 
可售开始时间
可选
created_at
string 
创建时间
可选
custom_cover
string 
主图视频自定义封面
可选
distribution_pattern
integer 
配送方式
可选
extend
object 
扩展
可选
freight
integer 
运费(单位:分)
可选
freight_template_id
integer 
运费模板ID
可选
goods_brief_text
string 
商品简介
可选
goods_category_id
string 
商品分类id
可选
goods_detail_text
string 
商品详情/买点
可选
goods_img
array[string]
可选
商品封面图(默认封面图)
goods_name
string 
商品名称
可选
goods_tag
string 
商品标签
可选
goods_tag_is_show
integer 
可选
商品标签是否展示(0:不展示;1:展示)
has_distribute
integer 
是否参与推广分销
可选
id
integer 
自增主键
可选
img_url_compressed
string 
可选
压缩后的列表配图url
is_best
integer 
可选
是否精品(0否 1是)
is_deleted
integer 
可选
是否删除(0正常 1已删除)
is_display
integer 
是否显示
可选
is_forbid
integer 
可选
商品是否被封禁(0 = 否,1 = 是)
is_free
integer 
可选
0-收费 1-免费(0-收费 1-免费)
is_goods_package
integer 
是否带货
可选
is_hot
integer 
可选
是否热销产品(0否 1是)
is_ignore
integer 
可选
商品是否被忽略(0 = 否,1 = 是)
is_new
integer 
可选
是否新品(0否 1是)
is_password
integer 
可选
是否加密(0-不加密 1—加密)
is_public
integer 
可选
是否公开售卖(0-不公开 1-公开)
is_recom
integer 
可选
是否推进(0否 1是)
is_single
integer 
可选
是否为单品(0-否 1-是)
is_stop_sell
integer 
可选
是否停售(0否 1是)
is_timing_sale
integer 
可选
是否定时上架(1是 0否)
is_uniform_freight
integer 
可选
是否是统一运费(1:统一运费 2:运费模板)
limit_purchase
integer 
限购数量
可选
period
integer 
可选
有效期(-1 永久,大于等于0是真实有效期)
period_type
integer 
可选
有效期类型(0-长期有效;1-具体时间前有效;2-有效期时间范围(秒))
period_value
string 
有效期值
可选
price_high
integer 
可选
商品高价(取自最低价所在sku对应化线价)
price_line
integer 
可选
划线价(取值price_low所在sku划线价)
price_low
integer 
可选
商品最低价(取自sku中最低价值)
pv
integer 
可选
学员学习该资源的总次数
resource_id
string 
资源id
可选
resource_type
integer 
可选
资源类型(1-图文、2-音频、3-视频、4-直播、5-会员、6-专栏、8-大专栏、25-训练营、29-线下课、45-AI互动课)
sale_at
string 
上架的时间
可选
sale_status
integer 
可选
上架状态(0下架 1上架 2待上架)
sell_mode
integer 
可选
售卖类型(1-自营 2-内容市场)
sell_type
integer 
可选
付费类型(付费类型:1 = 独立售卖,2 = 关联售卖)
show_stock
integer 
可选
是否展示库存(0-不展示 1-展示)
sku
array [object {20}] 
sku信息
可选
spu_id
string 
统一商品id
可选
spu_type
string 
统一商品类型
可选
stock
array [object {7}] 
库存信息
可选
stock_deduct_mode
integer 
可选
扣库存方式(0付款减库存 1拍下减库存)
timing_sale
string 
定时上架的时间
可选
updated_at
string 
更新时间
可选
uv
integer 
学习该资源的学员数
可选
video_img_url
string 
可选
实物商品主图视频封面url
video_url
string 
可选
实物商品主图视频文件url
visit_num
integer 
访问量
可选
wx_goods_category_id
string 
微信商品分类id
可选
上一页
获取训练营营期任务
下一页
商品详情1.0
Built with