# 商品列表完整版
接口地址： http://www.damaijia168.com/vv/external/productgetDetailItemList
请求方式： POST
传参方式： JSON
返回格式： JSON
# 请求头参数
| 参数 | 类型 | 必选 | 值 | 示例 |
|---|---|---|---|---|
| Authorization | string | 是 | 授权 access_token | 1798c6aadec33d1bc2f5b707f1049aefexxxx |
# 请求参数
| 参数 | 类型 | 必选 | 描述 |
|---|---|---|---|
| shop_id | string | 是 | 店铺id |
| id | string | 否 | 商品编号，使用id查询其他条件可以不填 |
| status | integer | 否 | 商品审核结果(0为编辑中，1为待审核，2为审核通过) |
| create_time_from | integer | 否 | 商品创建时间开始时间，unix-time时间戳 |
| create_time_to | integer | 否 | 商品创建时间结束时间，unix-time时间戳 |
| update_time_from | integer | 否 | 商品更新时间开始时间，unix-time时间戳 |
| update_time_to | integer | 否 | 商品更新时间结束时间，unix-time时间戳 |
| buyable | boolean | 否 | 是否在架上 |
| stock_gte | integer | 否 | 库存大于等于某数 |
| stock_lte | integer | 否 | 库存小于等于某数 |
| page_no | integer | 否 | 返回页码 默认 1，页码从 1 开始 p_s：当前采用分页返回，数量和页数会一起传，如果不传，则采用 默认值 |
| page_size | integer | 否 | 返回数量，默认50最大100 |
| barcode | string | 否 | 商品条码 |
| skucode | string | 否 | 小红书编码 |
| freeze | boolean | 否 | 是否被冻结 true为已冻结，false为未冻结 |
| single_pack_only | boolean | 否 | 只返回单品类型的商品 |
| show_deleted | boolean | 否 | - |
| last_id | string | 否 | 查询起始商品id，全店商品时间倒序 |
| is_channel | boolean | 否 | 不传返回全部，传true只返回渠道商品，传false只返回非渠道商品 |
| edition | string | 否 | 版本 默认:1(不传默认为1) 1:1.0,2:2.0 |
# 请求示例
{
}
# 请求代码示例
cURL请求代码示例
PHP请求代码示例
JAVA请求代码示例
Pyton请求代码示例
# 响应参数
| 名称 | 类型 | 示例值 | 描述 |
|---|---|---|---|
| data | object | 数据信息 | |
| --current_page | integer | 1 | 当前返回页 |
| --page_size | integer | 50 | 查询总数 |
| --total | integer | 500 | 总商品数 |
| --hits | array | 商品详情列表 | |
| ----spu_data | object | - | |
| ----id | string | spu标题 | spu_id,创建时不填，删除更新必填 |
| ----name | string | spu标题 | spu标题 |
| ----ename | string | spu_e_name | spu英文名 |
| ----alias_name | string | spu别名 | spu别名 |
| ----short_name | string | spu短标题，不得超过30的长度，其中中文字符占两个长度 | spu短标题 |
| ----business_line_id | string | 52d0****7d4b | 业务线条i_d |
| ----brand_id | string | 52dd****7d4b | 品牌i_d |
| ----category_id | string | 5a31****9df5 | 末级商品类目i_d |
| ----attributes | array | spu属性 | |
| ----shipping_template_id | string | null | 运费模板i_d |
| ----shipping_gross_weight | integer | 100 | 商品物流重量（克），当运费模版选择按重量计费时，该值必须大于0 |
| ----sale_method | string | DEFAULT/BOUTIQUE/SUPERMARKET | 售卖方式 |
| ----variant_ids | array | spu下商品规格列表 | |
| ----is_auto_off_sale | boolean | true | 是否自动下架，创建不需要，渠道商品更新时候使用 |
| ----auto_off_sale_time | integer | 1617877270000 | 自动下架时间，创建不需要，渠道商品更新时候使用 |
| ----inventory_type | integer | 1 | 库存类型（1: 普通库存；3: 独立库存），创建不需要，渠道商品更新时候使用，若普通商品修改库存为独立库存可能导致无法售卖 |
| ----spu_type | string | n_or_ma_l | spu_type 0:n_or_ma_l(普通商品),1:u_ni_on(组合商品) |
| ----is_channel | boolean | true | 是否为渠道商品，true:是渠道商品，false：非渠道商品 |
| ----create_time | integer | spu创建时间 | |
| ----update_time | integer | spu更新时间 | |
| ----item_data | object | - | |
| ----spu_id | string | spu标题 | spu编号 |
| ----id | string | 6123**5132 | item_id,仅更新删除返回使用 |
| ----sku_data | object | sku信息 | |
| ----sku_code | string | 65a0****f4d2 | sku编号，仅用于返回 |
| ----ipq | integer | 100 | 打包数 |
| ----original_price | number | 88 | 市场价 |
| ----price | number | 80 | 售价 |
| ----stock | integer | 5000 | 库存 |
| ----logistics_name | string | red_auto | 物流模式名 |
| ----logistics_plan_id | string | 5e37***a9f0 | 物流方案id |
| ----logistics_declaration_mode | string | uncertain | 物流申报模式 |
| ----wh_code | string | c_partner | 仓库编码 |
| ----price_type | integer | 1 | 是否包税 |
| ----erp_code | string | 001231 | 商家编码 |
| ----article_no | string | 123d12fd | 商品货号 |
| ----inventory_type | integer | 1 | 商品库存类型 |
| ----spl_data | object | spl信息 | |
| ----id | string | 65a0****d22f | spl编号，仅用于返回 |
| ----feature | string | 使用简单功能强大 | 八字真言：创建时必填 |
| ----image_urls | array | 主图url | |
| ----transparent_image_url | string | http://img.xiaohongshu.com/items/123456789 | 透明图 |
| ----image_desc_urls | array | 图文描述 | |
| ----user_guide_image_urls | array | 使用指南图片 | |
| ----variants | array | 规格列表 | |
| ----marketing_image_url | string | http://img.xiaohongshu.com/items/123456789 | 营销主图 |
| ----delivery_time | object | 发货时间信息 | |
| ----time | string | 2021/06/01 | 发货时间，相对时间(x)付款后x天内发货，绝对时间(y_yy_y/m_m/d_d)该天24点之前发货 |
| ----type | string | ABSOLUTE_TIME | 发货时间类型，DEFAULT:不设置 RELATIVE_TIME:相对时间 ABSOLUTE_TIME:绝对时间 |
| ----desc | string | 商品非常好用 | 商品描述 |
| ----video_url | string | http://img.xiaohongshu.com/items/123456789 | 主图视频 |
| ----faqs | array | 常见问题 | |
| ----spec_image_url | string | http://img.xiaohongshu.com/items/123456789 | 规格图（店铺为薯店时必填） |
| ----spv_data | object | spv信息 | |
| ----id | string | 65a0****d22f | s_pv编号,仅用于返回 |
| ----non_desc_variants | array | s_pv规格 | |
| ----barcode | string | red_test20200507001 | 商品条形码，创建特定品类必填 |
| ----country | string | 中国 | 原产国 |
| ----net_weight | number | 150 | 净重（单位克） |
| ----gross_weight | number | 130 | 毛重（单位克） |
| ----unit | string | 件/辆/把 | 计量单位 |
| ----buyable | boolean | true | 是否在架上，仅用于返回 |
| ----union_item_details | array | 组合商品子商品信息，仅返回使用 | |
| ----create_time | integer | 商品创建时间，仅返回使用 | |
| ----update_time | integer | 商品更新时间，仅返回使用 | |
| ----name | string | 商品名称，仅返回使用 | |
| ----additional_data | object | 商品额外信息，仅返回使用 | |
| --deduct_money | int | 1 | 消耗点券 |
| status | int | 0 | 状态码，0为成功 |
# 返回数据
{
"data": {
"deduct_money":1,
},
"status": 0
}
# 响应代码
| 代码 | 代码描述 | 解决方案 |
|---|---|---|
| 0 | 成功 | |
| 100 | 请求参数错误 | 检查您的请求参数是否正确 |
| 101 | 请求超时，请重试 | 检查您的网络情况或者联系客服解决 |
| 103 | 旺旺账号不存在 | 检查您输入的旺旺号是否正确 |
| 200 | 系统错误，请联系客服 | 检查您的接口地址填写是否正确，其他问题联系客服解决 |
| 203 | 暂不支持当前接口 | |
| 204 | 请求异常：无该接口权限，请前往官网开通正式接口。 | 前往官网开通该接口权限 |
| 204 | 请求异常：API调用次数不足,请前往网站兑换次数。 | 前往官网充值该接口调用次数 |
| 302 | 未授权店铺 | 根据返回链接进行扫码授权 |