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

获取商品


接口地址: http://api.vv-tool.com/tool/erps/1688get-commodity


接口介绍: 获取商品


必须用户授权 : 需要用户的授权,才能拿到被授权的数据


请求方式: POST


返回格式: JSON


接口收费: 联系运营


频率限制: 10 次/秒


请求头参数

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

请求参数

参数 类型 必选 描述
shop_id string 店铺 id
product_id int 商品 ID
web_site string 站点信息,指定调用的 API 是属于国际站(alibaba)还是 1688 网站(1688)
scene string 业务场景 零售通(lst) 1688 市场(1688)

请求示例

{
  "order_id": "201089727630969811",
  
"delayed_days": 7
}

请求代码示例

cURL请求代码示例
curl --location --request POST 'http://api.vv-tool.com/tool/erps/1688get-commodity' --header 'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf' --header 'Content-Type: application/json' --data-raw '{
    "product_id":1
}'
PHP请求代码示例
<?php

$curl = curl_init();

curl_setopt_array($curl, array(
  CURLOPT_URL => 'http://api.vv-tool.com/tool/erps/1688get-commodity',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => '',
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 0,
  CURLOPT_FOLLOWLOCATION => true,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => 'POST',
  CURLOPT_POSTFIELDS =>'{
    "product_id":1
}',
  CURLOPT_HTTPHEADER => array(
    'Authorization: Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf',
    'Content-Type: application/json'
  ),
));

$response = curl_exec($curl);

curl_close($curl);
echo $response;

JAVA请求代码示例
OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("application/json");
RequestBody body = RequestBody.create(mediaType, "{\r\n    \"product_id\":1\r\n}");
Request request = new Request.Builder()
  .url("http://api.vv-tool.com/tool/erps/1688get-commodity")
  .method("POST", body)
  .addHeader("Authorization", "Bearer 1798c6aadec33d1bc2f5b707f1049aefeaawf")
  .addHeader("Content-Type", "application/json")
  .build();
Response response = client.newCall(request).execute();

响应参数

名称 类型 描述
code int 返回状态码
msg string 返回码描述
msec int 接口执行时间
time int 接口返回时间
data object 数据信息
product_info object 商品详细信息
product_id int 商品 ID
product_type string 商品类型,在线批发商品(wholesale)或者询盘商品(sourcing),1688 网站缺省为 wholesale
category_id int 类目 ID,标识商品所属类目
attributes array 商品属性和属性值
attribute_id int 属性 ID
attribute_name string 属性名称
value_id int 属性值 ID
value string 属性值
is_custom bool 是否为自定义属性,国际站无需关注
group_id int[] 分组 ID,确定商品所属分组。1688 可传入多个分组 ID,国际站同一个商品只能属于一个分组,因此默认只取第一个
status string 商品状态。published:上网状态;member expired:会员撤销;auto expired:自然过期;expired:过期(包含手动过期与自动过期);member deleted:会员删除;modified:修改;new:新发;deleted:删除;TBD:to be delete;approved:审批通过;auditing:审核中;untread:审核不通过;
subject string 商品标题,最多 128 个字符
description string 商品详情描述,可包含图片中心的图片 URL
language string 语种,参见 FAQ 语种枚举值,1688 网站默认传入 CHINESE
period_of_validity int 信息有效期,按天计算,国际站无此信息
biz_type int 业务类型。1:商品,2:加工,3:代理,4:合作,5:商务服务。国际站按默认商品。
picture_auth bool 是否图片私密信息,国际站此字段无效
image object 商品主图
images array 主图列表,使用相对路径,需要增加域名:https://cbu01.alicdn.com/
is_watermark bool 是否打水印,是(true)或否(false),1688 无需关注此字段,1688 的水印信息在上传图片时处理
is_watermark_frame bool 水印是否有边框,有边框(true)或者无边框(false),1688 无需关注此字段,1688 的水印信息在上传图片时处理
watermark_position string 水印位置,在中间(center)或者在底部(bottom),1688 无需关注此字段,1688 的水印信息在上传图片时处理
sku_infos array sku 信息
attributes array SKU 属性值,可填多组信息
attribute_id int sku 属性 ID
att_value_id int sku 值 ID,1688 不用关注
attribute_value string sku 值内容,国际站不用关注
custom_value_name string 自定义属性值名称,1688 无需关注
sku_image_url string sku 图片
attribute_display_name string sku 属性 ID 所对应的显示名,比如颜色,尺码
attribute_name string sku 属性 ID 所对应的显示名,比如颜色,尺码
attr_type string sku 属性类型;1-表示该属性是规格属性;2-表示该属性是规格扩展属性
cargo_number string 指定规格的货号,国际站无需关注
amount_on_sale int 可销售数量,国际站无需关注
retail_price double 建议零售价,国际站无需关注
price int 报价时该规格的单价,国际站注意要点:含有 SKU 属性的在线批发产品设定具体价格时使用此值,若设置阶梯价格则使用 priceRange
price_range array 阶梯报价,1688 无需关注
start_quantity int
price int
sku_code string 商品编码,1688 无需关注
sku_id int skuId, 国际站无需关注
spec_id string specId, 国际站无需关注
consign_price int 分销基准价。代销场景均使用该价格。无 SKU 商品查看 saleInfo 中的 consignPrice
sale_info object 商品销售信息
support_online_trade bool 是否支持网上交易。true:支持 false:不支持,国际站不需关注此字段
mix_whole_sale bool 是否支持混批,国际站无需关注此字段
sale_type string 销售方式,按件卖(normal)或者按批卖(batch),1688 站点无需关注此字段
price_auth bool 是否价格私密信息,国际站无需关注此字段
price_ranges array 区间价格。按数量范围设定的区间价格
start_quantity int
price int
amount_on_sale int 可售数量,国际站无需关注此字段
unit string 计量单位
min_order_quantity int 最小起订量,范围是 1-99999。
batch_number int 每批数量,默认为空或者非零值,该属性不为空时 sellunit 为必填
retailprice int 建议零售价,国际站无需关注
tax string 税率相关信息,内容由用户自定,国际站无需关注
sellunit string 售卖单位,如果为批量售卖,代表售卖的单位,该属性不为空时 batchNumber 为必填,例如 1"手"=12“件"的"手",国际站无需关注
quote_type int 普通报价-FIXED_PRICE("0"),SKU 规格报价-SKU_PRICE("1"),SKU 区间报价(商品维度)-SKU_PRICE_RANGE_FOR_OFFER("2"),SKU 区间报价(SKU 维度)-SKU_PRICE_RANGE("3"),国际站无需关注
consign_price int 分销基准价。代销场景均使用该价格。有 SKU 商品查看 skuInfo 中的 consignPrice
delivery_limit int 发货时间限制(非买保发货周期),按开计算
shipping_info object 商品物流信息
freight_template_id int 运费模板 ID,0 表示运费说明,1 表示卖家承担运费,其他值表示使用运费模版。此参数可调用运费模板相关 API 获取
unit_weight int 单位重量
package_size string 尺寸,单位是厘米,长宽高范围是 1-9999999。1688 无需关注此字段
volume int 体积,单位是立方厘米,范围是 1-9999999,1688 无需关注此字段
handling_time int 备货期,单位是天,范围是 1-60。1688 无需处理此字段
send_goods_address_id int 发货地址 ID,国际站无需处理此字段
send_goods_address_text string 发货地描述
extend_infos array 商品扩展信息
key string 扩展结构的 key
value string 扩展结构的 value
supplier_user_id string 供应商用户 ID
quality_level int 质量星级(0-5)
supplier_login_id string 供应商 loginId
category_name string 类目名
main_vedio string 主图视频播放地址
product_cargo_number string 商品货号,产品属性中的货号
cross_border_offer bool 是否海外代发
reference_price string 参考价格,返回价格区间,可能为空
create_time string 创建时间
last_update_time string 最后操作时间
expire_time string 过期时间
modify_time string 修改时间
approved_time string 审核时间
last_repost_time string 最后重发时间
booked_count string 成交量
product_line string 产品线
detail_vedio string 详情视频
international_trade_info object 商品国际贸易信息,1688 无需处理此字段
fob_currency string FOB 价格货币,参见 FAQ 货币枚举值
fob_min_price string FOB 最小价格
fob_max_price string FOB 最大价格
fob_unit_type string FOB 计量单位,参见 FAQ 计量单位枚举值
payment_methods array 付款方式,参见 FAQ 付款方式枚举值
min_order_quantity int 最小起订量
min_order_unit_type string 最小起订量计量单位,参见 FAQ 计量单位枚举值
supply_quantity int supplyQuantity
supply_unit_type string 供货能力计量单位,参见 FAQ 计量单位枚举值
supply_period_type string 供货能力周期,参见 FAQ 时间周期枚举值
delivery_port string 发货港口
delivery_time string 发货期限
consignment_date int 新发货期限
packaging_desc string 常规包装
biz_group_infos array 产品业务的支持信息,support 为 false 说明不支持。
support bool 是否支持
description string 垂直市场名字,如微供市场、货品市场
code string 垂直市场标记
seller_login_id string 卖家旺旺 ID
intelligent_info object 商品算法智能改写信息,包含算法优化后的商品标题和图片信息,未改写的则直接返回原标题和原图片
title string 算法优化后的商品标题
images array 算法优化后的商品图片
sku_images array 算法优化后的规格图片
sku_id int skuId
image_url string 算法处理后的图片地址,未处理则返回原图片地址
description_images array 算法优化后的详情图片
processing object 加工定制信息
image_list array 产品样图
image_id int 图片 ID
image_name string 图片名称
image_url string 图片地址
relation_category_list array 涵盖品类
category_id string 类目 ID
category_name string 类目名称
attribute_list array 加工定制属性
key string 属性 key
name string 属性名
value string 属性值
value_name string 属性值名称
relation_offer object 关联的现货
stock_offers int[] 关联的现货
trade_attributes object 交易信息
refer_price_list array 加工方式的参考价格
key string 参考价 key
refer_price object 参考价内容
prop_list array 参考价属性列表
key int 属性 key
value string 属性值
amount int 起订量
price int 价格区间(最低价)
max_price int 价格区间(最高价)
reserve_range_list array 出货周期
begin_amount int 订货数量
date int 预计出货时间(天)
end_amount int 订货截止数量
sample_price int 打样价格(支持打样需传此参数,单位:元)
sample_date int 打样周期(支持打样需传此参数,单位:天)
unit_name string 计量单位
min_reserve_amount int 最小预定数量
max_reserve_amount int 最大预定数量
biz_group_infos array 产品业务的支持信息,support 为 false 说明不支持。
support bool 是否支持
description string 垂直市场名字,如微供市场、货品市场
code string 垂直市场标记
withholding_money int 该接口扣费金额(点券)

返回数据


{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
    "expire_time": "20281215124625000+0800",
    "biz_group_infos": [
        {
            "support": false,
            "description": "零售通",
            "code": "is_retail_offer"
  },
        {
            "support": false,
            "description": "微供商品",
            "code": "is_micro_supply"
  },
        {
            "support": false,
            "description": "1688企业内部商城",
            "code": "is_emall_offer"
  },
        {
            "support": false,
            "description": "1688代销产品",
            "code": "is_consign_market_offer"
  },
        {
            "support": false,
            "description": "代发业务产品",
            "code": "has_linked_to_supplier"
  }
    ],
    "create_time": "20181216141253000+0800",
    "approved_time": "20181218124625000+0800",
    "product_info": {
        "product_id": 584240750353,
        "product_type": "wholesale",
        "category_id": 1043766,
        "attributes": [
            {
                "attribute_id": 2176,
                "attribute_name": "品牌",
                "value": "忆江南",
                "is_custom": false
    },
    
            {
      
                "attribute_id": 7869,
      
                "attribute_name": "是否进口",
      
                "value": "否",
      
                "is_custom": false
            
    },
    
            {
      
                "attribute_id": 159484581,
      
                "attribute_name": "原产国/地区",
      
                "value": "澳大利亚",
      
                "is_custom": false
            
    }
        ],
    
        "status": "published",
    
        "subject": "susui素水品牌304真空镀铜500ml透明盖高档保温杯高档随手保温杯",
    
        "description": "susui素水品牌304真空镀铜500ml透明盖高档保温杯高档随手保温杯",
    
        "language": "chinese",
    
        "period_of_validity": 3650,
    
        "biz_type": 1,
    
        "picture_auth": false,
    
        "image": {
      
            "images": [
                "img/ibank/2015/681/907/20397091861984794539.jpg",
      
                "img/ibank/2015/781/907/20397091871984794539.jpg",
      
                "img/ibank/2015/981/907/20397091891984794539.jpg",
      
                "img/ibank/2015/131/099/20369901311984794539.jpg",
      
                "img/ibank/2015/371/099/20369901731984794539.jpg",
      
                "img/ibank/2015/141/099/20369901411984794539.jpg",
      
                "img/ibank/2015/551/099/20369901551984794539.jpg"
            ]
        
    },
    
        "sku_infos": [
            {
      
                "attributes": [
                    {
        
                        "attribute_id": 3216,
        
                        "attribute_value": "清新蓝",
        
                        "sku_image_url": "img/ibank/2015/131/099/20369901311984794539.jpg",
        
                        "attribute_display_name": "颜色",
        
                        "attribute_name": "颜色"
                    
      },
      
                    {
        
                        "attribute_id": 2340,
        
                        "attribute_value": "500ml",
        
                        "attribute_display_name": "容量",
        
                        "attribute_name": "容量"
                    
      }
                ],
      
                "cargo_number": "",
      
                "amount_on_sale": 1000,
      
                "sku_code": "3941927601960",
      
                "sku_id": 3941927601960,
      
                "spec_id": "8ee78ffbdcb30c53861739e60be04325",
      
                "consign_price": 23
            
    }
        ],
    
        "sale_info": {
      
            "support_online_trade": true,
      
            "mix_whole_sale": false,
      
            "sale_type": "normal",
      
            "price_auth": false,
      
            "price_ranges": [
                {
        
                    "start_quantity": 3,
        
                    "price": 23
                
      },
      
                {
        
                    "start_quantity": 50,
        
                    "price": 22
                
      },
      
                {
        
                    "start_quantity": 500,
        
                    "price": 21
                
      }
            ],
      
            "amount_on_sale": 4047,
      
            "min_order_quantity": 3,
      
            "quote_type": 2,
      
            "consign_price": 23
        
    },
    
        "shipping_info": {
      
            "freight_template_id": 0
        
    },
    
        "extend_infos": [
            {
      
                "key": "is_support_step_pay",
      
                "value": "false"
            
    },
    
            {
      
                "key": "is_support_mix",
      
                "value": "false"
            
    },
    
            {
      
                "key": "is_alipay_supported",
      
                "value": "true"
            
    }
        ],
    
        "quality_level": 6,
    
        "product_cargo_number": "透明盖保温杯",
    
            "processing":  {
      
      "attribute_list":  [
        {
        
          "key":  "production_capacity",
        
          "name":  "生产产能",
        
          "value":  "10",
        
          "value_name":  "双"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2201",
        
          "value_name":  "来样加工"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2202",
        
          "value_name":  "来图加工"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2204",
        
          "value_name":  "贴牌加工"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2305",
        
          "value_name":  "加印logo"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "2306",
        
          "value_name":  "包装物料"
        
      },
      
        {
        
          "key":  "order_mode",
        
          "name":  "加工方式",
        
          "value":  "9999",
        
          "value_name":  "其他加工"
        
      },
      
        {
        
          "key":  "production_grade",
          "name":  "生产档次",
          "value":  "v2",
          "value_name":  "中等"
      },
        {
          "key":  "production_grade",
          "name":  "生产档次",
          "value":  "v1",
          "value_name":  "高级"
      },
        {
          "key":  "production_grade",
          "name":  "生产档次",
          "value":  "v4",
          "value_name":  "大众"
      }
      ],
      "image_list":  [
        {
          "image_id":  15307542938,
          "image_name":  "b2de9c82d158ccbf256dd55512d8bc"
      }
      ],
      "relation_category_list":  [
        {
          "category_id":  "54>127484008>201158704",
          "category_name":  "服饰配件、饰品>手套/袖套>婚庆手套"
      }
      ],
      "relation_offer":  {
        "stock_offers":  [
          631375849349
        ]
      },
      "trade_attributes":  {
        "refer_price_list":  [
          {
            "key":  "2306",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "包装物料"
            }
              ]
          }
        },
          {
            "key":  "2305",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "加印logo"
            }
              ]
          }
        },
          {
            "key":  "2204",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "贴牌加工"
            }
              ]
          }
        },
          {
            "key":  "2202",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "来图加工"
            }
              ]
          }
        },
          {
            "key":  "2201",
            "refer_price":  {
              "amount":  1000,
              "max_price":  10000.0,
              "price":  1000.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "来样加工"
            }
              ]
          }
        },
          {
            "key":  "9999",
            "refer_price":  {
              "amount":  10,
              "max_price":  1000.0,
              "price":  100.0,
              "prop_list":  [
                {
                  "key":  30,
                  "value":  "其他加工"
            }
              ]
          }
        }
        ],
        "reserve_range_list":  [
          {
            "begin_amount":  2000,
            "date":  2000
        }
        ],
        "sample_price":  100.0,
        "sample_time":  100,
        "unit_name":  "件"
      }
    },
        "create_time": "20181216141253000+0800",
        "last_update_time": "20181218124625000+0800",
        "expire_time": "20281215124625000+0800"
  },
    "last_update_time": "20181218124625000+0800",
    "last_repost_time": "20181218124625000+0800"
}

}

响应代码

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