# 商品详情2.0
|拥有此API的权限集|
|:----- |
|商品管理-查询商品信息|
**请求方式及url**
- 请求方式：`POST`
- 请求头：`Content-Type:application/json`
- 接口地址：`https://api.xiaoe-tech.com/xe.goods.detail.get/4.0.0`
- 频率限制：`10秒3000次`
{%
api
method="POST",
data={
"access_token": "xe_xxxx",
"resources":[
{
"type":2,
"ids":[
"a_619fba7ae4b03f3fb99c7809"
]
}
],
"body":"stock,sku,attr"
},
url="https://api-doc.xiaoe-tech.com/_agent/forward?url=https://api.xiaoe-tech.com/xe.goods.detail.get/4.0.0" %}
{% endapi %}
**请求参数**
|参数名|必选|类型|说明|
|:---- |:---|:----- |:----- |----|
|access_token |是 |string |[专属token](./../get_access_token.md) |
|resources[].ids |是 |array |资源ID集合，可使用[查询商品列表2.0](./get_goods_relations_2.md)获取resource_id的值 |
|resources[].type |是 |int |资源类型，可使用[查询商品列表2.0](./get_goods_relations_2.md)获取resource_type的值 |
|is_return_deleted |否 |int |是否删除 0正常 1已删除 不传默认返回所有数据 |
|is_return_forbid |否 |int |商品是否被封禁：0 = 否，1 = 是 不传默认返回所有数据|
|is_cache |否 |bool |是否查询缓存：false = 否，true = 是 默认是 |
|body |否 |string |传“stock”查询库存信息，传sku查sku相关信息,传attr查属性相关信息，不传则不查附属信息 |
**备注**
* `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-课程（训练营pro），68-服务类商品
**请求示例**
```
{
"access_token": "xe_xxxx",
"resources":[
{
"type":2,
"ids":[
"a_619fba7ae4b03f3fb99c7809"
]
}
],
"body":"stock,sku,attr"
}
```
**返回参数**
|参数名|必选|类型|说明|
|:----- |:----|:-----|:-----|
|code |int|状态码 |0为请求成功，其它为请求失败|
|msg |string|请求状态描述信息 |无 |
|data |object | 返回数据 | 无 |
`data`返回数据
|参数名|必选|类型|说明|
|:----- |:----|:-----|:-----|
|id |int|自增主键|无 |
|app_id |string|店铺ID |无 |
|sku_cost_price |int | sku成本价，单位：分 |无 |
|sku_volume |string | sku体积 |无 |
|sku_spec_code |string| sku规格编码 |无 |
|sku_weight |string| sku重量 |无 |
|resource_id|string|资源id |无 |
|resource_type|int|资源类型|1-图文、2-音频、3-视频、4-直播、5-会员、6-专栏、8-大专栏、25-训练营、29-线下课、45-AI互动课|
|spu_id |string|统一商品id|无 |
|spu_type |string|统一商品类型 |无 |
|spu_type_name |string|统一商品类型名称 |无 |
|goods_sn |string|商品编号（商家录入） |无 |
|goods_category_id |string|商品分类id|无 |
|wx_goods_category_id |string|微信商品分类id |无 |
|goods_name|string|商品名称|无 |
|goods_img |array|商品封面图（默认封面图）|无 |
|custom_cover | string |主图视频自定义封面 |无 |
|detail_cos_url | string |富文本的cos链接 |无 |
|goods_brief_text |string|商品简介|无 |
|goods_detail_text |string|商品详情/买点 |无 |
|sell_type |int|付费类型|付费类型：1 = 独立售卖，2 = 关联售卖|
|price_low |int|商品最低价（取自sku中最低价值） |单位：分 |
|price_high|int|商品高价（取自最低价所在sku对应划线价）|单位：分 |
|price_line|int|划线价(取值price_low所在sku划线价) |单位：分 |
|visit_num |int|访问量 |无 |
|goods_tag |string|商品标签|无 |
|goods_tag_is_show |int|商品标签是否展示 |0:不展示;1:展示 |
|sale_status|int|上架状态|0下架 1上架 2待上架 |
|is_timing_sale |int|是否定时上架 |1是 0否 |
|is_timing_off |int|是否定时下架 |1是 0否 |
|timing_sale|string|定时上架的时间 |若没有则默认为0000-00-00 00:00:00 |
|timing_offtime|string|实际下架的时间 |若没有则默认为0000-00-00 00:00:00 |
|timing_off|string|定时下架的时间 |若没有则默认为0000-00-00 00:00:00 |
|sale_at |string|上架的时间|无 |
|has_distribute |int|是否参与推广分销 |0 = 否，1 = 是|
|is_goods_package |int|是否带货|0 否 1 是 |
|is_display|int|是否显示|0否(隐藏状态) 1是(显示状态)|
|is_stop_sell|int|是否停售|0否 1是 |
|is_forbid |int|商品是否被封禁 |0 = 否，1 = 是|
|is_ignore |int|商品是否被忽略 |0 = 否，1 = 是|
|is_deleted|int|是否删除|0正常 1已删除|
|created_at|string|创建时间|无 |
|updated_at|string|更新时间|无 |
|video_img_url|string|实物商品主图视频封面url |无 |
|limit_purchase |int|限购数量|无 |
|stock_deduct_mode |int|扣库存方式|0付款减库存 1拍下减库存 |
|appraise_num|int|评价数 |无 |
|show_stock|int|是否展示库存 |0-不展示 1-展示 |
|is_best |int|是否精品|0否 1是 |
|is_hot |int|是否热销产品 |0否 1是 |
|is_new |int|是否新品|0否 1是 |
|is_recom |int|是否推荐|0否 1是 |
|freight |int|运费（单位：分） |无 |
|img_url_compressed |string|压缩后的列表配图url |无 |
|freight_template_id |int|运费模板ID|无 |
|is_uniform_freight |int|是否是统一运费 |1:统一运费 2:运费模板 |
|is_public |int|是否公开售卖 |0-不公开 1-公开 |
|is_password|int|是否加密|0-不加密 1—加密 |
|is_free |int|是否免费|0-收费 1-免费|
|can_sold_start |string|可售开始时间 |无 |
|can_sold_end|string|可售结束时间 |无 |
|is_single |int|是否为单品|0-否 1-是 |
|custom_cover|string|主图视频自定义封面 |无 |
|period |int|有效期 |-1 永久，大于等于0是真实有效期|
|distribution_pattern |int|配送方式|无 |
|sell_mode |int|售卖类型|1-自营 2-内容市场 |
|period_type|int|有效期类型|0-长期有效；1-具体时间前有效；2-有效期时间范围（秒）|
|period_value|string|有效期值|无 |
|stock |array|库存信息|无 |
|sku |array|sku信息|无 |
|attr |array|属性信息|无 |
|extend |object|扩展 |无 |
|extend.sell_num |int|售卖数量|无 |
|pv |int|学员学习该资源的总次数 |无 |
|uv |int|学习该资源的学员数 |无 |
|attach_count|int|带货的数量|无 |
`data.stock`库存信息
|参数名|必选|类型|说明|
|:----- |:----|:-----|:-----|
|sku_id |string|商品 SKU_ID |无 |
|stock_type |int|库存类型|0-数量购买，2-买断/免费 |
|setting_stock |int|设置库存|无 |
|sell_num |int|售卖数量|无 |
|left_num |int|剩余数量|无 |
|is_deleted |int|记录是否已被删除 |0 = 否，1 = 是|
|remark |string|属性备注|无 |
`data.sku`sku信息
|参数名|必选|类型|说明|
|:----- |:----|:-----|:-----|
|sku_id|string|商品 SKU_ID |无 |
|sku_business_id |string|资源侧的 SKU_ID |无 |
|attr_data |array|属性信息|无 |
|sku_img |int|sku默认图片 |无 |
|sku_name |int|sku名字|无 |
|sku_desc |int|规格描述|无 |
|sku_price |int|价格 |无 |
|sku_line_price |string|划线价 |无 |
|limit_purchase |int|限购数量|无 |
|limit_purchase_type|int|限购类型|0-无限制 1-每个用户购买次数 2-有效期内每个用户购买次数|
|sku_min_purchase |int|起购数量|(最小购买数量,0为不限制)默认0|
|period_type |int|有效期类型|0-长期有效；1-具体时间前有效；2-有效期时间范围（秒）|
|period_value |string|有效期值|无 |
|value_count |int|规格 |1-单规格 2-多规格 |
|order_sku_limit |int|下单是否受库存限制 |0 = 否，1 = 是|
|state|int|上下架状态|1上架 0下架|
|is_default |int|是否默认|0-否1-是 |
|is_deleted |int|是否已被删除 |0 = 否，1 = 是|
|is_free |int|是否免费|0 = 否，1 = 是|
**返回示例**
```
{
"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": "",
"detail_cos_url":"",
"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-125252xxxx.file.myqcloud.com/appAKLWLitnxxxx/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-125252xxxx.file.myqcloud.com/appAKLWLitnxxxx/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-125252xxxx.file.myqcloud.com/appAKLWLitnxxxx/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": "",
"visit_num": 2,
"wx_goods_category_id": ""
}
]
}
```
- 开发前必读
- 小鹅云介绍
- 更新日志
- 开始开发
- 开发指南
- 创建并授权应用
- 获取access_token（含代码示例）
- 开通接口权限
- 全局返回码
- 常用工具
- 日志排查工具
- 场景方案
- 同步用户场景
- 同步商品场景
- 同步订购关系场景
- 同步积分场景
- 同步页面统计场景
- 同步学习数据场景
- 同步推广员场景
- 内嵌SDK服务场景
- 产品介绍
- 产品简介
- 客户案例
- 接入流程
- 业务文档
- 账号打通
- 支付
- 直播带货
- 商品同步
- 订单同步
- 学习数据同步
- 企业内训
- PCweb
- H5web
- 流量变现
- App分享
- 微页面装修
- 直播连麦
- 技术文档
- 小鹅通SDK开发者声明
- 小鹅通SDK个人信息保护政策(2022年9月28日生效)
- 小鹅通SDK个人信息保护政策(2022年9月28日失效)
- 开发指南
- 原生SDK登录态
- Android-SDK 接入
- iOS-SDK 接入
- WebSDK接入
- 小程序接入
- 小程序支付接入
- 代币支付签名算法
- SDK&H5账号详解
- 发布日志（iOS）
- 发布日志（Android）
- 常见问题
- 消息推送
- 使用说明
- 消息加/解密
- 消息接收URL校验说明
- 订单状态推送
- 用户手机号变更推送
- 用户状态变更推送
- 积分变更消息推送
- 商品变更推送
- 考试消息推送
- 活动签到推送
- 订单支付推送
- 账号合并推送
- 用户注册推送
- 优惠券消息推送
- 信息采集推送
- 权益变更推送
- 用户标签变更消息推送
- API列表
- 获取access_token（含代码示例）
- 用户管理
- 使用说明
- 注册新用户
- 更新用户信息
- 获取用户列表2.0
- 获取用户列表1.0
- 查询单个用户信息
- 批量查询用户信息
- 获取用户消费信息
- 获取课程学员列表
- 获取训练营pro学员列表
- 获取会员卡用户信息
- 查询单个用户标签列表
- 查询用户合并记录
- 获取标签列表
- 添加/修改标签
- 添加/修改用户标签
- 获取用户反馈列表
- 获取用户反馈回复列表
- 回复用户反馈
- 学习数据管理
- 获取学习记录列表
- 获取每日学习记录
- 获取指定资源学习记录信息
- 获取营期下用户的学习情况
- 获取训练营pro学员任务详情
- 直播管理
- 获取直播列表
- 批量查询指定直播间列表信息
- 获取班课列表
- 获取签到列表
- 获取签到学员列表
- 获取直播红包列表
- 获取红包领取记录
- 获取直播数据概览
- 获取直播详情
- 获取直播详情2.0
- 获取红包数据概况
- 获取直播间讨论区消息列表
- 获取直播间多段推流记录
- 创建直播
- 编辑直播
- 上架/下架直播
- 删除直播
- 获取直播间用户列表
- 商品管理
- 查询商品列表2.0
- 查询商品列表1.0
- 查询组合课资源列表4.0
- 查询组合课资源列表3.0
- 获取训练营营期任务
- 商品详情2.0
- 商品详情1.0
- 获取课程关联的助学工具
- 获取直播带货商品列表
- 获取实物商品评论列表
- 商品增加库存
- 商品减少库存
- 新建实物商品
- 编辑实物商品
- 删除实物商品
- 获取实物商品类目列表
- 获取C端搜索商品列表
- 商品分组管理
- 获取店铺商品分组列表
- 获取商品分组内商品列表
- 批量新建/更新商品分组
- 删除商品分组
- 素材管理
- 获取素材列表
- 获取素材分组列表
- 素材分组编辑
- 素材分组移动
- 素材分组删除
- 订单管理
- 获取订单列表2.0
- 获取订单详情2.0
- 获取订单列表1.1
- 获取订单列表1.0
- 查询用户订单列表
- 获取订单详情
- 获取买赠订单信息
- 待付款订单改价
- 获取售后订单列表
- 获取售后订单详情
- 订单退款
- 订购管理
- 用户开通产品包权益2.0
- 用户开通产品包权益
- 查询用户订购资源列表
- 用户购买关系查询
- 查询用户资源权益2.0
- 查询用户资源权益1.0
- 取消订购
- 批量开通用户产品包权益-创建任务
- 批量开通用户产品包权益-查询任务列表
- 批量开通用户产品包权益-查询任务详情
- 物流管理
- 普通实物单发货(即将下线)
- 获取物流公司信息列表
- 订单全部商品发货
- 订单部分商品发货
- 修改已发货订单的物流信息
- 获取运费模板列表
- 推广员管理
- 查询推广员列表
- 查询推广员客户列表
- 查询推广员的下级推广员列表
- 查询指定推广员的信息
- 查询客户所属推广员
- 查询推广员名下新增/过期客户
- 新增推广员
- 推广员绑定客户
- 修改/解除绑定关系
- 设置推广员上级
- 推广订单详情
- 按日期查询推广员的收益和新增加的下级
- 推广订单详情(支持购物车订单返回多条记录)
- 信息采集管理
- 获取信息采集列表
- 获取单个信息采集结果
- 获取用户信息采集结果
- 根据表单ID以及用户ID获取信息采集结果
- 营销码券管理
- 优惠券列表
- 获取优惠券详情2.0
- 获取优惠券详情
- 获取优惠券领券用户
- 发放优惠券2.0
- 发放优惠券
- 优惠券核销
- 获取优惠码列表
- 获取优惠码码库列表
- 获取优惠码效果数据
- 创建优惠码
- 优惠码添加库存
- 优惠码失效
- 编辑优惠码
- 优惠码删除
- 获取兑换码码库列表
- 追加兑换码库存
- 创建兑换码
- 编辑兑换码
- 兑换码失效
- 用户使用兑换码
- 获取兑换码批次列表
- 作废单个兑换码
- 积分管理
- 查询用户积分日志
- 获取单个用户积分信息
- 批量获取用户积分列表
- 获取店铺积分信息
- 批量发放积分
- 批量扣减积分
- 解冻冻结积分
- 设置店铺积分过期时间
- 业务类型说明
- 页面统计管理
- 新建页面统计
- 编辑页面统计
- 获取页面统计列表
- 获取页面统计详情
- 获取页面统计订单列表
- 新建投放渠道
- 获取投放渠道列表
- 打卡管理
- 获取打卡列表
- 获取打卡参与用户
- 获取指定学员活动日记列表
- 获取活动点赞列表
- 获取指定学员被点赞总数和列表
- 获取用户日记被点评/评论列表
- 获取指定打卡的作业列表
- 获取学员的打卡日记列表
- 获取打卡关联的课程信息
- 练习管理
- 获取练习基本信息列表
- 获取练习结果列表
- 获取练习详情
- 获取学员练习答题详情
- 作业管理
- 获取作业本列表
- 获取作业基本信息列表
- 获取作业结果列表
- 获取作业详情
- 获取学员作业答题详情
- 圈子管理
- 获取用户参与的圈子
- 考试管理
- 获取考试列表
- 获取考试详情
- 获取考试结果列表信息
- 获取考试结果详细信息
- 活动管理
- 获取活动列表
- 获取签到列表
- 获取活动报名列表
- 获取活动签到信息
- 组织管理
- 获取员工列表
- 获取员工详细信息
- 添加或者保存员工信息
- 启用员工
- 停用员工
- 删除员工
- 根据员工账号获取用户ID
- 获取组织结构树
- 添加或修改组织架构
- 移除组织架构
- 微页面管理
- 获取微页面列表
- 企学院专用(不对外开放)
- 学员管理（限企学院）
- 企学院获取学员列表
- 企学院添加学员
- 企学院修改学员
- 企学院删除学员
- 企学院添加组织架构
- 企学院删除组织架构
- 企学院编辑组织架构
- 企学院获取组织架构
- 企学院获取部门信息
- 活动管理（限企学院）
- 企学院用户签到活动列表
- 培训计划管理（限企学院）
- 获取培训计划列表
- 获取培训计划详情
- 获取用户培训学习数据
- 获取员工的培训计划列表
- 常见问题
- 问题汇总
- 问题反馈