维易淘客联盟接口开发文档:批量查询商品

批量检测商品是否下架,批量查询商品信息

本接口主要用于批量查询商品信息,以及检测是否为淘客商品或下架。


一、接口地址 getitems

http://api.vephp.com/tbk/getitems?vekey=xxx&ids=651196798743,646724659836,650353754885


参数:

ids 参数:必选,你要检测的批量商品ID列表,用英文逗号相连。如 646724659836,650353754885,一次最大40个ID。

如果是字符型ID,则支持B段入参数,或A-B全段字符型ID入参。如:

(1) B段ID入参:krVR92U8kAGPDqvT5,BVORbxsrv3jZYn2HD6

(2)A-B段完整ID入参:5mmRxkntxt0G74DC0OWHYCV-krVR92U8kAGPDqvT5,4DDqWdyigtYWnr7tQPxtQCg-BVORbxsrv3jZYn2HD6

(3)数字ID入参:646724659836,650353754885

【id入参特别提示】

请不要把上述三种类型的ID混合在一起入参,混合式的ID参数只能查询第一个ID代表的格式,比如第一个是数字ID,则全部入参中的数字ID会被查询到,而字符ID会查询失败。

比如:ids=BVORbxsrv3jZYn2HD6,652100129322,第一个是字符型ID的B段,则只能查询入参ID中的所有B段IDBVORbxsrv3jZYn2HD6,反过来ids=652100129322,BVORbxsrv3jZYn2HD6 只能查询到652100129322等所有数字ID



二、接口返回值:

接口返回值如下图:


字段含义如下:

erro : 出错时error不为0

msg:提示字段

id_count : 总共查询的ID数,是去掉重复的ID数后的数

success :  成功数

fail :  失败数,fail+success=id_count

fail_ids :  如果有失败的ID,则在这里输出,这些ID是下架的或非淘客的商品ID。如果没有失败ID,则本字段为空。


返回的产品字段参数:

cat_leaf_name 叶子类目名称

cat_name  一级类目名称

free_shipment  是否包邮

hot_flag 是否是热门商品,0不是,1是

item_url 商品链接

ju_online_end_time  聚划算信息-聚淘结束时间(毫秒)

ju_online_start_time 聚划算信息-聚淘开始时间(毫秒)

ju_pre_show_end_time  聚划算信息-商品预热结束时间(毫秒)

ju_pre_show_start_time  聚划算信息-商品预热开始时间(毫秒)

material_lib_type 商品库类型,支持多库类型输出,以英文逗号分隔“,”分隔,1:营销商品主推库,如果值为空则不属于1这种商品类型

nick  店铺名称

num_iid 商品ID

pict_url  主图

presale_deposit  预售商品-定金(元)

presale_end_time  预售商品-付定金结束时间(毫秒)

presale_start_time  预售商品-付定金开始时间(毫秒)

presale_tail_end_time 预售商品-付定金结束时间(毫秒)

presale_tail_start_time 预售商品-付尾款开始时间(毫秒)

provcity  商品所在地

reserve_price 商品一口价格

seller_id 卖家id

small_images 商品小图列表

superior_brand 是否品牌精选,0不是,1是

title 商品标题

tmall_play_activity_end_time 天猫限时抢可售 -结束时间(毫秒)

tmall_play_activity_start_time 天猫限时抢可售 -开始时间(毫秒)

user_type  卖家类型,0表示集市,1表示商城,3表示特价版

volume  30天销量

zk_final_price 折扣价(元) 若属于预售商品,付定金时间内,折扣价=预售价

 

客服