全部
淘宝
拼多多
抖音
京东
快手
当当
1688
淘工厂
小红书
有赞
微店
在线测试

获取商品详情


接口地址: http://www.yunyingtool.com/papi/tool/erps/productdetail


接口介绍: 获取商品的详细信息(默认读取的是线上数据,而非草稿数据;如无线上数据,则读取草稿数据)


请求方式: POST


返回格式: JSON


接口收费: 联系客服


频率限制: 10 次/秒


请求头参数

参数 类型 必选 示例
Authorization string 授权 access_token Bearer 1798c6aadec33d1bc2f5b707f1049aefexxxx

请使用新的生成 token 接口

请求参数

参数 类型 必选 描述
shop_id String 店铺 id
product_id String 商品 id
out_product_id String 外部商品 id
show_draft String "true":读取草稿数据;"false":读取上架数据
vvtype int 普通版 1,增强版 2,专业版 3 目前此接口只支持 2

请求示例

{
shop_id: 1234444,
product_id: 123131,
show_draft: true,
out_product_id: 12344,
vvtype: 2

}

请求代码示例

cURL请求代码示例

PHP请求代码示例


JAVA请求代码示例


响应参数

名称 类型 示例值 描述
product_id Int64 3539925204033339668 商品 ID
product_id_str String 3539925204033339668 商品 ID,字符串格式
out_product_id Int64 11111 商品外部 ID
outer_product_id String 11111 商品外部 ID 字符串
open_user_id Int64 1 open 应用 id
name String xxx 爽肤水 商品名称
description String <img src="https://tosv.boe.byted.org/obj/temai/54cbf542128eff94a3549284817c0af5bf5c2960www800-800" style="width:100%;"> 详情 HTML
delivery_method Int32 7 承诺发货时间,单位是天 不传则默认为 2 天,presell_type 为 0 或 2 均只支持传入 2,presell_type 为 1 时支持可选值为: 2、3、5、7、10、15
cdf_category String 1 海南免税:海关限购分类编码
status Int64 1 商品上下架状态:0 上架 1 下架 2 已删除
spec_id Int64 1 规格 id
check_status Int64 1 商品审核状态:1 未提审 2 审核中 3 审核通过 4 审核驳回 5 封禁 7 审核通过,待上架状态
mobile String 15677775555 手机号
brand_id Int64 12344 品牌 id
is_sub_product Bool true 是否是组套商品的子商品
draft_status Int64 2 草稿状态:0 无草稿,1 未提审,2 待审核,3 审核通过,4 审核未通过
category_detail Struct - 新类目的详情
first_cid Int64 23264 一级类目 id
second_cid Int64 0 二级类目 id
third_cid Int64 0 三级类目 id
fourth_cid Int64 0 四级类目 id
first_cname String 教育培训 一级类目名
second_cname String 学习卡 二级类目名
third_cname String - 三级类目名
fourth_cname String - 四级类目名
pay_type Int64 1 支持的支付方式:0 货到付款 1 在线支付 2 两者都支持
recommend_remark String 真的很好啊 商家推荐语
extra String - 扩展字段
is_create Int64 1 已废弃,无业务意义
create_time String 2021-03-29 15:52:52 创建时间
update_time String 2021-03-29T15:52:52+08:00 更新时间
pic List ["https://sf6-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"] 商品主图
product_format String {"货号":"8888"} 属性名称
spec_pics List - 规格图片
spec_detail_id Int64 1695459998447656 id
pic String temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800 uri
spec_prices List - sku 详情
sku_id Int64 1695459998495774 sku id
out_sku_id Int64 0 外部 sku id
outer_sku_id String 0 字符串形式外部 sku id
spec_detail_ids List [1695459998494734, 1695459998494766] 规格 id
stock_num Int64 13 // 当前现货可售库存、当前预售可售库存(物理库存)
price Int64 102 价格
code String aaa 编码
step_stock_num Int64 0 阶梯库存
prom_stock_num Int64 0 活动库存
prom_step_stock_num Int64 0 活动阶梯库存
spec_detail_id1 Int64 1695459998494734 规格 ID
spec_detail_id2 Int64 1695459998494734 规格 ID
spec_detail_id3 Int64 0 规格 ID
sku_type Int64 0 sku 类型
supplier_id String 123 供应商编码
promotion_stock_num Int64 0 活动现货库存
promotion_step_stock_num Int64 0 活动阶梯库存
customs_report_info Struct - 海关申报要素
hs_code String 1564564 海关代码
first_measure_qty Double 1 法定第一计量数量
second_measure_qty Double 1 法定第二计量数量
first_measure_unit String - 法定第一计量单位
second_measure_unit String - 法定第二计量单位
unit String - 售卖单位
report_name String - 品名
report_brand_name String - 品牌
usage String - 用途
g_model String - 规格型号
bar_code String - 条形码
lock_stock_num Int64 1 现货订单锁定库存
lock_step_stock_num Int64 1 阶梯订单锁定库存
stock_num_map Map - 仓 ID-> 库存映射
tax_exemption_sku_info Struct - 海南免税 sku 信息
is_suit Int32 1 是否套装(0 否 1 是)
suit_num Int64 10 套装数量
volume Int64 100 净含量
presell_delay Int64 5 sku 预售、现货 + 预售、新预售模式下,sku 对应的预售天数
- specs List 销售属性
id Int64 1713023986705415 销售属性 id
spec_id Int64 1713023983665214 规格 id
name String 颜色 销售属性
pid Int64 1713023986705415 销售属性 id
is_leaf Int16 0 是否是销售属性值
values List - 销售属性值
id Int64 1695459998447656 销售属性值 ID
spec_id Int64 1713023983665214 规格 ID
name String 红色 销售属性值
pid Int64 1695459998447640 销售属性 ID
is_leaf Int16 1 是否是销售属性值
status Int16 1 状态
img String https://xxxx.byted.org/obj/temai/54cbf542128eff94a3549284817c0af5bf5c2960www800-800 头图,主图第一张
presell_type Int64 1 预售类型,1-全款预售,0-非预售,2-阶梯库存
maximum_per_order Int64 5 每个用户每次下单限购件数
limit_per_buyer Int64 5 每个用户累计限购件数
minimum_per_order Int64 1 每个用户每次下单至少购买的件数
quality_list List - 资质信息
quality_key String 3457***9470978 资质 key
quality_name String 进货凭证 资质名称
quality_attachments List - 资质链接
media_type Int64 1 1-图片,2-pdf
url String http://www.byted***.com/YYYY 资质 url
logistics_info Struct - 跨境物流信息
customs_clear_type Int64 1 通关模式,1BBC 2BC 3 邮关
origin_country_id Int64 123 原产国 id
source_country_id Int64 123 货源国 id
brand_country_id Int64 123 品牌所在地 id
tax_payer Int64 0 税金承担方,0 商家承担,1 用户承担
net_weight_qty Double 100 商品净重
after_sale_service String {"supply_7day_return":"2"} 售后服务
price_has_tax Int64 0 商品价格是否含税
appoint_delivery_day Int64 2 可预约发货天数
product_format_new String {"1088":[{"Value":0,"Name":"小 33 学二年级","PropertyId":1088,"PropertyName":"适用学龄段","diy_type":1}],"1319":[{"Value":0,"Name":"1","PropertyId":1319,"PropertyName":"适用地区","diy_type":0}],"1618":[{"Value":0,"Name":"9787218122861","PropertyId":1618,"PropertyName":"ISBN 编号","diy_type":0}],"1831":[{"Value":0,"Name":"小学英语看图说话写话二年级","PropertyId":1831,"PropertyName":"书名","diy_type":0}],"2000":[{"Value":34762,"Name":"无","PropertyId":2000,"PropertyName":"作者地区","diy_type":0}],"2229":[{"Value":0,"Name":"1","PropertyId":2229,"PropertyName":"编者","diy_type":0}],"3271":[{"Value":0,"Name":"1","PropertyId":3271,"PropertyName":"出版时间","diy_type":0}],"449":[{"Value":0,"Name":"1","PropertyId":449,"PropertyName":"作者","diy_type":0}],"501":[{"Value":7310,"Name":"否","PropertyId":501,"PropertyName":"是否是套装","diy_type":0}],"855":[{"Value":0,"Name":"陕西人民教育出版社","PropertyId":855,"PropertyName":"出版社名称","diy_type":0}]} 类目属性
standard_brand_id Int64 121354 品牌库 brand id,原 brand_id 代表商标关系 id
market_price Int64 12000 划线价 单位分
discount_price Int64 12000 售卖价 单位分
car_vin_code String VIN11111111111111 汽车 vin 码
need_recharge_mode Bool false 生活娱乐充值模式
account_template_id String 1 多账号充值账号模板
presell_config_level Int64 2 发货模式:presell_type = 0 现货;presell_type = 2 阶梯;presell_type = 1 && presell_config_level = 0 全款预售;presell_type = 1 && presell_config_level = 1 sku 预售;presell_type = 1 && presell_config_level = 2 现货 + 预售;presell_type = 1 && presell_config_level = 3 新预售
delivery_delay_day Int64 2 现货模式的发货天数;阶梯模式现货部分的发货天数,9999= 当日发、1= 次日发
presell_delay Int64 4 阶梯模式阶梯部分的发货天数;商品全款预售模式,预售天数
withholding_money Int64 该接口扣费金额(点券)

返回数据

{
  "code": 0,
  "msg": "操作成功",
  "msec": 1469,
  "time": 1617270403,
  "data": {
    "product_id": 3472490447010721067,
    "product_id_str": "3472490447010721067",
    "out_product_id": 1617004369,
    "outer_product_id": "1617004369",
    "open_user_id": 0,
    "name": "抖店开放平台自动化测试专用,勿动谢谢",
    "description": "<img src=\"https://sf6-ttcdn-tos.pstatp.com/obj/temai/93addf0cd27c5ac835767731e33aa1dfe02c5854www750-1336\" style=\"width:100%;\">",
    "market_price": 200,
    "discount_price": 100,
    "status": 0,
    "spec_id": 1695459998447624,
    "check_status": 2,
    "mobile": "18888888888",
    "first_cid": 1305,
    "second_cid": 1399,
    "third_cid": 2523,
    "category_detail": {
      "first_cid": 20077,
      "second_cid": 21129,
      "third_cid": 0,
      "fourth_cid": 0,
      "first_cname": "教育培训",
      "second_cname": "学习卡",
      "third_cname": "",
      "fourth_cname": ""
    },
    "pay_type": 1,
    "recommend_remark": "remark...",
    "extra": "{\"category_detail\":{\"first_cid\":20077,\"first_cname\":\"教育培训\",\"fourth_cid\":0,\"fourth_cname\":\"\",\"is_leaf\":true,\"second_cid\":21129,\"second_cname\":\"学习卡\",\"third_cid\":0,\"third_cname\":\"\"},\"class_quality\":\"https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800,https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\",\"is_publish\":1,\"quality_list\":[{\"quality_key\":\"1\",\"quality_name\":\"进货凭证1\",\"quality_attachments\":[{\"media_type\":1,\"url\":\"https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\"},{\"media_type\":1,\"url\":\"https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\"}]},{\"quality_key\":\"2\",\"quality_name\":\"进货凭证2\",\"quality_attachments\":[{\"media_type\":1,\"url\":\"https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800\"}]}],\"quality_report\":\"\",\"stone\":{\"remark\":\"商家备注\"}}",
    "is_create": 0,
    "create_time": "2021-03-29 15:52:52",
    "update_time": "2021-03-29T15:52:52+08:00",
    "pic": [
      "https://sf6-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"
    ],
    "product_format": "{\"货号\":\"8888\"}",
    "spec_pics": [
      {
        "spec_detail_id": 1695459998447656,
        "pic": "temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800"
      },
      {
        "spec_detail_id": 1695459998447672,
        "pic": "temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800"
      },
      {
        "spec_detail_id": 1695459998494734,
        "pic": "temai/b637513c50b994f4c89de56a17886caca5d6569awww800-800"
      }
    ],
    "spec_prices": [
      {
        "sku_id": 1695459998495774,
        "out_sku_id": 0,//外部商家sku_id
        "outer_sku_id": "",//新增,推荐使用,外部商家sku_id,支持字符串和数字2种
        "spec_detail_ids": [
          1695459998494734,
          1695459998494766
        ],
        "stock_num": 13,
        "price": 102,
        "code": "",
        "settlement_price": 102,
        "step_stock_num": 0,
        "prom_stock_num": 0,
        "prom_step_stock_num": 0,
        "spec_detail_id1": 1695459998494734,
        "spec_detail_id2": 1695459998494766,
        "spec_detail_id3": 0,
        "sku_type": 0,
        "supplier_id": "",
        "promotion_stock_num": null,
        "promotion_step_stock_num": null,
        "customs_report_info": {
          "hs_code": "",
          "first_measure_qty": 0,
          "second_measure_qty": 0,
          "first_measure_unit": "",
          "second_measure_unit": "",
          "unit": "",
          "report_name": "",
          "report_brand_name": "",
          "usage": "",
          "g_model": "",
          "bar_code": ""
        },
        "lock_stock_num": 0,
        "lock_step_stock_num": 0,
        "stock_num_map": null
      },
      {
        "sku_id": 1695459998495758,
        "out_sku_id": 0,
        "outer_sku_id": "",
        "spec_detail_ids": [
          1695459998447672,
          1695459998494766
        ],
        "stock_num": 12,
        "price": 101,
        "code": "",
        "settlement_price": 101,
        "step_stock_num": 0,
        "prom_stock_num": 0,
        "prom_step_stock_num": 0,
        "spec_detail_id1": 1695459998447672,
        "spec_detail_id2": 1695459998494766,
        "spec_detail_id3": 0,
        "sku_type": 0,
        "supplier_id": "",
        "promotion_stock_num": null,
        "promotion_step_stock_num": null,
        "customs_report_info": {
          "hs_code": "",
          "first_measure_qty": 0,
          "second_measure_qty": 0,
          "first_measure_unit": "",
          "second_measure_unit": "",
          "unit": "",
          "report_name": "",
          "report_brand_name": "",
          "usage": "",
          "g_model": "",
          "bar_code": ""
        },
        "lock_stock_num": 0,
        "lock_step_stock_num": 0,
        "stock_num_map": null
      },
      {
        "sku_id": 1695459998494782,
        "out_sku_id": 123456788,
        "outer_sku_id": "123456788",
        "spec_detail_ids": [
          1695459998447656,
          1695459998494766
        ],
        "stock_num": 11,
        "price": 100,
        "code": "16076589507w",
        "settlement_price": 100,
        "step_stock_num": 0,
        "prom_stock_num": 0,
        "prom_step_stock_num": 0,
        "spec_detail_id1": 1695459998447656,
        "spec_detail_id2": 1695459998494766,
        "spec_detail_id3": 0,
        "sku_type": 0,
        "supplier_id": "56788",
        "promotion_stock_num": null,
        "promotion_step_stock_num": null,
        "customs_report_info": {
          "hs_code": "",
          "first_measure_qty": 0,
          "second_measure_qty": 0,
          "first_measure_unit": "",
          "second_measure_unit": "",
          "unit": "",
          "report_name": "",
          "report_brand_name": "",
          "usage": "",
          "g_model": "",
          "bar_code": ""
        },
        "lock_stock_num": 0,
        "lock_step_stock_num": 0,
        "stock_num_map": null
      }
    ],
    "specs": [
      {
        "id": 1695459998447640,
        "spec_id": 1695459998447624,
        "name": "颜色",
        "pid": 0,
        "is_leaf": 0,
        "values": [
          {
            "id": 1695459998447656,
            "spec_id": 1695459998447624,
            "name": "红色",
            "pid": 1695459998447640,
            "is_leaf": 1,
            "status": 0
          },
          {
            "id": 1695459998447672,
            "spec_id": 1695459998447624,
            "name": "黄色",
            "pid": 1695459998447640,
            "is_leaf": 1,
            "status": 0
          },
          {
            "id": 1695459998494734,
            "spec_id": 1695459998447624,
            "name": "蓝色",
            "pid": 1695459998447640,
            "is_leaf": 1,
            "status": 0
          }
        ]
      },
      {
        "id": 1695459998494750,
        "spec_id": 1695459998447624,
        "name": "尺寸",
        "pid": 0,
        "is_leaf": 0,
        "values": [
          {
            "id": 1695459998494766,
            "spec_id": 1695459998447624,
            "name": "S",
            "pid": 1695459998494750,
            "is_leaf": 1,
            "status": 0
          }
        ]
      }
    ],
    "img": "https://sf6-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800",
    "presell_type": 0,
    "maximum_per_order": 0,
    "limit_per_buyer": 0,
    "minimum_per_order": 1,
    "quality_list": [
      {
        "quality_key": "1",
        "quality_name": "进货凭证1",
        "quality_attachments": [
          {
            "media_type": 1,
            "url": "https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"
          },
          {
            "media_type": 1,
            "url": "https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"
          }
        ]
      },
      {
        "quality_key": "2",
        "quality_name": "进货凭证2",
        "quality_attachments": [
          {
            "media_type": 1,
            "url": "https://sf1-ttcdn-tos.pstatp.com/obj/temai/0c71ce6acb4e3b508e0d30042b1a94262818ab41www800-800"
          }
        ]
      }
    ],
    "logistics_info": {
      "customs_clear_type": 0,
      "origin_region_id": 0,
      "source_region_id": 0,
      "brand_region_id": 0,
      "tax_payer": 0,
      "net_weight_qty": 0
    },
    "after_sale_service": "{\"supply_7day_return\":\"2\"}",
    "price_has_tax": 0
  }
}

响应代码

代码 代码描述 解决方案
0 成功
100 请求参数错误 检查您的请求参数是否正确
101 请求超时,请重试 检查您的网络情况或者联系客服解决
103 旺旺账号不存在 检查您输入的旺旺号是否正确
200 系统错误,请联系客服 检查您的接口地址填写是否正确,其他问题联系客服解决
202 系统错误,请稍后再试 稍后重试,或则连接对接群
203 暂不支持当前接口
204 请求异常:无该接口权限,请前往官网开通正式接口。 前往官网开通该接口权限
204 请求异常:API 调用次数不足,请前往网站兑换次数。 前往官网充值该接口调用次数
302 未授权店铺 根据返回链接进行扫码授权