V兔API开放平台

名称	类型	是否必须	描述	示例值
shop_id	string	是	店铺 id	123
signs	string[]	否	业务标	['is_micro_supply']
page_no	integer	是	分页参数，起始为 1	1
page_size	integer	是	分页参数，每页大小，目前最大值为 20，超过 20 时以 20 为准	20
status_list	string[]	否	商品状态，published:上架状态，expired：过期(包含手动过期与自动过期)，t_bd：to be delete，deleted：删除，new：新发，modified：修改，member expired：会员撤销	['published']
category_id	long	否	类目 i_d	1031728
start_modify_time	java.util.date	否	产品修改开始时间	20180717174002000+0800
end_modify_time	java.util.date	否	产品修改结束时间	20180717174002000+0800
subject_key	string	否	关键词	北极
cargo_number	string	否	货号	l_yq-8816
product_ids	long[]	否	产品 i_d 列表	[12323213,12312323]
begin_star	integer	否	星级范围起始值 0-5，不能高于 end_star	0
end_star	integer	否	星级范围起始值 0-5，不能低于 begin_star	5
group_ids	string	否	查询自定义分组 i_d，目前只支持查询一个	100416219
start_publish_time	java.util.date	否	发布时间起始值	20180717174002000+0800
end_publish_time	java.util.date	否	发布时间结束值	20180717174002000+0800
start_expired_time	java.util.date	否	过期时间起始值	20180717174002000+0800
end_expired_time	java.util.date	否	过期时间结束值	20180717174002000+0800
price_start	double	否	价格范围起始值	1.0
price_end	double	否	价格范围结束值	1000.0
order_by_condition	string	否	排序条件 CREATE_DATE,POST_DATE,MODIFY_DATE,APPROVED_DATE,EXPIRE_DATE,STATUS,ID,GROUP_ID,PRICE,SALE_QUANTITY：	PRICE
order_by_type	string	否	升序 ASC 还是降序 DESC	DESC
support_online_trade	boolean	否	支持在线交易	true
private_offer	boolean	否	私密商品	false
need_detail	boolean	否	是否需要详情	true
need_freight	boolean	否	是否需要运费	true
need_user_category_info	boolean	否	是否需要自定义类目	true

请求示例

请求代码示例

cURL请求代码示例

PHP请求代码示例

JAVA请求代码示例

响应参数

名称	类型	描述	示例
result	message:alibaba.product.product_info_list_result	查询结果	{}
page_result	message:alibaba.product.page_result	查询结果
size_per_page	integer	每页数量
result_list	message:alibaba.product.product_info[]	商品列表
product_i_d	long	商品 i_d	584051070147
product_type	string	商品类型，在线批发商品(wholesale)或者询盘商品(sourcing)，1688 网站缺省为 wholesale	wholesale
category_i_d	long	类目 i_d，标识商品所属类目	1048182
attributes	message:alibaba.product.product_attribute[]	商品属性和属性值	[]
attribute_i_d	long	属性 i_d	973
attribute_name	string	属性名称	风格
value_i_d	long	属性值 i_d
value	string	属性值	民族风
is_custom	boolean	是否为自定义属性，国际站无需关注	false
group_i_d	long[]	分组 i_d，确定商品所属分组。1688 可传入多个分组 i_d，国际站同一个商品只能属于一个分组，因此默认只取第一个	[107331682]
status	string	商品状态。published:上网状态;member expired:会员撤销;auto expired:自然过期;expired:过期(包含手动过期与自动过期);member deleted:会员删除;modified:修改;new:新发;deleted:删除;t_bd:to be delete;approved:审批通过;auditing:审核中;untread:审核不通过;	published
subject	string	商品标题，最多 128 个字符	高端气质 o_l 韩版雪纺女装套头半高领长袖修身型蕾丝衫
description	string	商品详情描述，可包含图片中心的图片 u_rl	高端气质 o_l 韩版雪纺女装套头半高领长袖修身型蕾丝衫
language	string	语种，参见 f_aq 语种枚举值，1688 网站默认传入 c_hi_ne_se	e_ng_li_sh
period_of_validity	integer	信息有效期，按天计算，国际站无此信息	3650
biz_type	integer	业务类型。1：商品，2：加工，3：代理，4：合作，5：商务服务。国际站按默认商品。	1
picture_auth	boolean	是否图片私密信息，国际站此字段无效	false
image	message:alibaba.product.product_image_info	商品主图	{}
sku_infos	message:alibaba.product.product_s_ku_info[]	sku 信息	[]
sale_info	message:alibaba.product.product_sale_info	商品销售信息	{}
shipping_info	message:alibaba.product.product_shipping_info	商品物流信息	{}
extend_infos	message:alibaba.product.product_extend_info[]	商品扩展信息	[]
supplier_user_id	java.lang.string	供应商用户 i_d	1234
quality_level	integer	质量星级(0-5)	5
supplier_login_id	java.lang.string	供应商 login_id	alitestforisv01
category_name	java.lang.string	类目名	连衣裙
main_vedio	java.lang.string	主图视频播放地址	https://cloud.video.taobao.com/play/u/1685/p/1/e/6/t/1/5224**.mp4
product_cargo_number	java.lang.string	商品货号，产品属性中的货号	666
cross_border_offer	boolean	是否海外代发	true
reference_price	java.lang.string	参考价格，返回价格区间，可能为空	500
create_time	java.util.date	创建时间	20181213201638000+0800
last_update_time	java.util.date	最后操作时间	20181219175505000+0800
expire_time	java.util.date	过期时间	20281216175505000+0800
modify_time	java.util.date	修改时间	20281216175505000+0800
approved_time	java.util.date	审核时间	20181219175505000+0800
last_repost_time	date	最后重发时间	20181219175505000+0800
booked_count	string	成交量	1999
product_line	string	产品线	默认
detail_vedio	string	详情视频	https://cloud.video.taobao.com/play/u/1685/p/1/e/6/t/1/5224**.mp4
international_trade_info	message:alibaba.product.product_international_trade_info	商品国际贸易信息，1688 无需处理此字段
biz_group_infos	message:alibaba.product.product_biz_group_info[]	产品业务的支持信息，support 为 false 说明不支持。	[]
seller_login_id	string	卖家旺旺 i_d	卖家旺旺 i_d
intelligent_info	message:com.alibaba.ocean.openplatform.biz.product.common.model.product_intelligent_info	商品算法智能改写信息，包含算法优化后的商品标题和图片信息，未改写的则直接返回原标题和原图片	[]
processing	message:alibaba.product.product_processing	加工定制信息	默认
total_records	integer	商品总数量
page_index	integer	当前页码
message	string	错误信息
success	boolean	是否成功	true
code	string	错误码
withholding_money	int	该接口扣费金额（点券）	1

返回数据

{
    "code": 0,
    "msg": "操作成功",
    "msec": 1469,
    "time": 1617270403,
    "data": {
          "withholding_money":1,
         
      }   
      
  
}

响应代码

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