文档中心 > API类目 > 闲鱼已验货

alibaba.idle.isv.item.query (服务商闲鱼商品查询)

服务商ISV闲鱼商品查询

公共参数

请求地址：

环境	HTTP请求地址	HTTPS请求地址
正式环境	http://gw.api.taobao.com/router/rest	https://eco.taobao.com/router/rest

公共请求参数：

名称	类型	是否必须	描述
method	String	是	API接口名称。
app_key	String	是	TOP分配给应用的AppKey。
target_app_key	String	否	被调用的目标AppKey，仅当被调用的API为第三方ISV提供时有效。
sign_method	String	是	签名的摘要算法，可选值为：hmac，md5。
sign	String	是	API输入参数签名结果，签名算法介绍请点击这里。
session	String	否	用户登录授权成功后，TOP颁发给应用的授权信息，详细介绍请点击这里。当此API的标签上注明：“需要授权”，则此参数必传；“不需要授权”，则此参数不需要传；“可选授权”，则此参数为可选。
timestamp	String	是	时间戳，格式为yyyy-MM-dd HH:mm:ss，时区为GMT+8，例如：2015-01-01 12:00:00。淘宝API服务端允许客户端请求最大时间误差为10分钟。
format	String	否	响应格式。默认为xml格式，可选值：xml，json。
v	String	是	API协议版本，可选值：2.0。
partner_id	String	否	合作伙伴身份标识。
simplify	Boolean	否	是否采用精简JSON返回格式，仅当format=json时有效，默认值为：false。

请求参数

名称	类型	是否必须	示例值	更多限制	描述
param	IdleItemBaseApiDo	可选			商品查询参数
└ item_id Number 必须 12235345546 闲鱼商品Id └ need_sku Boolean 可选 true 是否需要sku信息(不需要的业务场景，不要设置为true，会增加查询耗时)

响应参数

名称	类型	示例值	描述
result	TopResult	无	返回结果result
data IdleItemApiDo 无 data └ category_id Number 32456789 类目Id └ desc String 全新，红色，超便宜商品描述(长度<=5000) └ division_id Number 330110 行政区划Id(城市编码)，最小行政单位code，若是地区级别，则为地区级别的id；否则为城市级别的id(long型，6位) └ img_urls String [] [] 图片链接 └ inspect_report String http://inspect_report.html [已废弃]验货报告, 此字段后续会废弃；如需使用参见: inspected_data.inspect_report └ item_id Number 商品id 商品Id（long型） └ original_price String 50.02 商品原价, 单位：元(最大99999999) └ reserve_price String 35.31 商品售价, 单位：元(最大99999999) └ sp_biz_type String 1 1 服务商商品业务分类，手机:1, 潮品:2, 家电:3, 乐器:8, 3C数码:9, 奢品:16, 母婴:17, 美妆:18, 文玩/珠宝:19, 潮玩:20, 家居:21 └ status Number 0 商品状态，可选值为0（表示上架），-2（表示下架），-1（表示删除），99（其他） └ stuff_status Number 99 商品新旧程度, 值为-1-100的整数，例如100代表全新，-1代表准新，95代表95新 └ title String iphoneX手机特卖商品标题 └ trade_type Number 1 交易方式, 仅在线交易: 0,仅线下交易: 1,线上OR线下交易: 2（int型，1位） └ transport_fee String 5.87 邮费, 单位：元(最大99999999) └ item_biz_type Number 1 业务模式 0不入仓，1入仓，2寄卖 └ ware_house_city String 杭州 [已废弃]已验货入仓城市(此字段后续会废弃；如需使用参见: inspected_data.ware_house_city) └ ware_house_time Number 1615863262 [已废弃]已验货入仓时间(此字段后续会废弃；如需使用参见: inspected_data.ware_house_time) └ item_tags String [] ["TEST"] 商品业务标签，不可修改 └ channel_cat_id String 12345567 渠道类目id，不可修改 pv_list IdleNewPubValueDo [] 属性的键值对信息，包括品牌、型号、内存大小（手机）等 └ property_id String 21553 属性id └ property_name String 品牌属性名称 └ channel_cat_id String 1451 渠道类目id └ value_id String 12354 值id └ value_name String Apple/苹果值名称 item_sku_list IdleItemApiSkuDo [] sku列表 └ sku_id Number 2342345456 skuId └ quantity Number 13 库存 └ price Number 8 价格，单位分 property_list IdleItemApiPvPairDo [] 销售属性列表(最多2个销售属性,每一个的属性值个数为2～10) └ property_text String 尺码属性名文本 └ value_text String XL 属性值文本 └ outer_id String 32452435456 外部商家标识(商品编码对接ERP等) └ supply_price String 1.0 sku参考供货价，单位元 └ cspu_id Number 32452435456 cspud inspected_data IdleItemApiInspectedDo 已验货业务数据 └ inspect_report String http://inspect_report.html 验货报告url链接(长度<=300) └ ware_house_city String 深圳已验货入仓城市，入仓模式必填，不可修改 └ ware_house_time Number 1620544846 已验货入仓时间，入仓模式必填，时间戳，单位秒，不可修改 book_data IdleItemApiBookDo 图书业务数据 └ barcode String 9787111302832 图书ISBN码 └ barcode_name String 计算机科学丛书图书ISBN码对应的书名等信息 └ quantity Number 10 商品库存 └ outer_id String 190085448924 外部商品编码 └ template_id Number 40090611110 淘宝卖家后台的运费模板id bid_data IdleItemApiBidDo 拍卖业务数据 └ bid_item_id Number 324453452343 拍卖商品id └ bid_start_time Number 1630896653000 拍卖开始时间,毫秒时间戳(精度为分钟) └ bid_end_time Number 1630896753000 拍卖结束时间,毫秒时间戳(精度为分钟) └ bid_bail Number 3200 买家参拍保证金金额，单位：分 └ bid_step Number 100 出价幅度金额(起拍价使用reserve_price)，单位：分 └ current_bid_price Number 56700 当前出价金额, 最高出价, 单位分 └ bid_count Number 35 总出价次数 └ delay_count Number 2 最后两分钟被出价的延迟次数 └ support_task_for_free Number 1 是否支持做任务免保证金（for新奥莱拍卖业务）, 0-不支持，1-支持 └ task_list String [] 任务列表（for新奥莱拍卖业务） cycle_vendue_data IdleItemApiCycleVendueDO 周期拍信息 └ cycle_buy_remain_count Number 5 活动库存，即周期拍剩余次数 └ cycle_buy_start_time Number 1629949200000 拍品周期拍开拍时间戳，单位毫秒 └ cycle_buy_end_time Number 1629953200000 拍品周期拍结束时间戳，单位毫秒 └ cycle_vendue Number 1 是否周期拍拍品，0-不是，1-是 └ cycle_buy_activity_id Number 3478 周期拍活动id └ direct_buy_price Number 100 抢拍价金额，单位分 └ auction_type String a 商品类型： b 一口价；a 拍卖 └ white_bg_img_urls String [] [] 商品白底图 └ sp_guarantee String 1,2,3 [已废弃]商品服务标签，用逗号分隔 \|\| 1：100%验货；2：正品鉴别；3：七天包退；4：一年质保；5：48小时发货；7：质量问题包退；8：一物一证 distribution_data IdleItemDistributionDO 国际分销业务独有数据 └ product_price String 0.5 货品供货价，国际分销场景中使用 └ product_id String 123456 后端货品id,在国际分销场景下使用 └ inv_grade String 1 对应的货品库存等级，在库良品：1，临期品：139，一级残次：137，二级残次：138，在库残次：101 └ market_site String QIAN_NIU 商品来源类型 after_sales_data IdleItemApiAfterSalesDO 卖家服务信息 └ support_sdr_policy Boolean true 是否支持七天无理由 └ support_nfr_policy Boolean false 是否支持描述不符包邮退 └ support_vnr_policy Boolean false 是否支持虚拟-描述不符包退 └ support_fd24hs_policy Boolean false 是否支持极速发货-24小时 └ support_fd10ms_policy Boolean false 是否支持极速发货-10分钟 └ support_fd48hs_policy Boolean false 是否支持极速发货-48小时 └ support_gpa_policy Boolean false 是否支持假货包赔 └ support_nfgc_policy Boolean false 是否支持不符必赔 idle_item_api_auto_recharge_do IdleItemApiAutoRechargeDO 商品直充相关信息 └ template_code String accountInputBox 直充模板code └ template_extra_info String PHONE 模版的额外参数 └ owner Boolean true 当前服务商是否拥有直充编辑权限 idle_item_yhb_do IdleItemApiYhbDO 验货宝信息 └ use_yhb_service Boolean true 是否开启验货宝 └ settings_preferences String {} 验货宝相关配置 real_car_verify_data IdleItemApiYhbDO 真车认证相关信息 └ driving_license_info String http://1231231 行驶证主页图片url └ driving_license_car_photo String http://1231231 行驶证车辆页图片url └ business_license_front String http://1231231 营业执照图片url └ car_function String 营运使用性质 : 营运 / 非营运 └ car_vin String 123123 车辆识别代码 VIN码 biz_help_data IdleItemApiBizHelpDataDO 帮卖信息 └ first_phase_order_id Number 123 一段订单号 flash_sale_do IdleItemApiFlashSaleDO 特卖商品相关信息 └ tag Number 1 特卖商品标签 └ food_pro_date Date 2024-01-01 00:00:00 食品的生产日期 └ food_expire_date Date 2024-01-01 00:00:00 食品的保质期过期时间 └ b2c_big_shipper_id String 21313 大货主ID └ b2c_small_shipper_id String 123 小货主ID └ b2c_small_shipper_name String 小货主小货主名称 └ out_sync_item_id Number 123 淘工厂商品ID └ out_sync_item_name String 测试商品淘工厂商品名称 └ out_sync_sku_id Number 123 淘工厂SKU ID └ idle_template_id Number 123 运费模板ID property_images IdleItemSkuImageInfoApiDO [] sku属性图片 └ url String 12313 图片链接 └ property_text String 颜色 sku对应的属性text └ value_text String 红色 sku对应的属性值text long_images IdleItemImageInfoApiDO [] 长图信息 └ width Number 12 宽度 └ height Number 12 高度 └ url String 12 图片链接 └ weight String 9.97 运费模版重量 └ weight_unit String kg 运费模版重量单位 trendy_pre_sale_do IdleItemTrendyPreSaleDO 预售工具参数 └ dep_model Number 1 订金模式 1-收取固定金额 2-按比例收取金额 └ dep_config String 10 订金配置: 1-固定金额模式存储订金金额 2-按比例金额模式，存储比例 └ start_time String 1725623518000 开始时间 └ end_time String 1725623518000 结束时间 └ g_time String 1725623518000 出荷时间 └ notify_message String 为了保障游戏账号商品交易安全，买家需等待30天才能确认收货发布成功，编辑成功，查询场景，返回给服务商的提醒信息 brand_bargain IdleItemApiBrandBargainDO 捡漏类型商品成色信息 └ item_stuff String 20 品牌成色 └ produce_date String 1725623518000 生产日期，时间戳 └ shelf_life String 12 保质期, 多少天过期 └ supplier String 闲鱼测试供应商名称 └ cert_pic_id Number 1232132131231 证照图片文件id └ cert_pic_url String http://1231231 证照图片url store_group_do IdleItemApiStoreGroupDO 门店库信息 └ group_id Number 27033 门店库Id └ group_name String 肯德基全国门店门店库名称 distribution_item_info IdleDistributionItemInfoDO 分销商品信息 └ out_sync_item_id String 842472706080 外部商品id └ product_id String 562455585535 货品ID └ out_sync_item_biz_code String idleDistribution 外部bizCode └ distributor_user_id String 2212935862056 分销商用户ID └ source_from String 1 商品来源 └ out_supply_id String 2217601284340 供应商id └ primary_channel_code String tmallchaoshipm 一级渠道Id └ sub_channel_code String tmallchaoshipm_xianyu 二级渠道Id └ out_sync_inventory_grade String 1 库存等级 └ out_sync_sku_id String 5688665204001 外部skuId └ need_stuff_custom Boolean false 是否需要成色定制表达：千牛 └ stuff_value_id String 15994218 成色定制表达-valueId：千牛 └ stuff_value_name String 几乎全新成色定制表达-valueName：千牛 trendy_chou_shang_do IdleItemTrendyChouShangDO 抽赏信息 └ chou_shang_item Boolean true 是否为抽赏商品 └ group_box_id String 74001 赏箱ID └ chou_shang_post_item Boolean false 是否为抽赏邮费商品 item_lease_do ItemLeaseDO 商品租赁信息 └ rental_deposit_price_in_cent String 1000 租赁押金 └ sec_kill_time Number 1744697687762 秒杀商品开始时间毫秒时间戳 └ err_code String PARAM_ILLEGAL 错误码 └ err_msg String 参数不合法错误信息 └ success Boolean false 是否成功

请求示例

JAVA
.NET
PHP
CURL
Python
C/C++
NodeJS

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleIsvItemQueryRequest req = new AlibabaIdleIsvItemQueryRequest();
AlibabaIdleIsvItemQueryRequest.IdleItemBaseApiDo obj1 = new AlibabaIdleIsvItemQueryRequest.IdleItemBaseApiDo();
obj1.setItemId(12235345546L);
obj1.setNeedSku(true);
req.setParam(obj1);
AlibabaIdleIsvItemQueryResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaIdleIsvItemQueryRequest req = new AlibabaIdleIsvItemQueryRequest();
AlibabaIdleIsvItemQueryRequest.IdleItemBaseApiDoDomain obj1 = new AlibabaIdleIsvItemQueryRequest.IdleItemBaseApiDoDomain();
obj1.ItemId = 12235345546L;
obj1.NeedSku = true;
req.Param_ = obj1;
AlibabaIdleIsvItemQueryResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaIdleIsvItemQueryRequest;
$param = new IdleItemBaseApiDo;
$param->item_id="12235345546";
$param->need_sku="true";
$req->setParam(json_encode($param));
$resp = $c->execute($req, $sessionKey);

curl -X POST 'http://gw.api.taobao.com/router/rest' \
-H 'Content-Type:application/x-www-form-urlencoded;charset=utf-8' \
-d 'app_key=12129701' \
-d 'format=json' \
-d 'method=alibaba.idle.isv.item.query' \
-d 'partner_id=apidoc' \
-d 'session=46c3ed77-2745-46df-b3be-e2a4223d9140' \
-d 'sign=EFB97CE7CA2F68A6536550DFD5FBCB92' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-18+05%3A02%3A03' \
-d 'v=2.0' \
-d 'param=null'

# -*- coding: utf-8 -*-
import top.api

req=top.api.AlibabaIdleIsvItemQueryRequest(url,port)
req.set_app_info(top.appinfo(appkey,secret))

req.param=""
try:
	resp= req.getResponse(sessionkey)
	print(resp)
except Exception,e:
	print(e)

pTopRequest pRequest = alloc_top_request();
pTopResponse pResponse = NULL;
pTaobaoClient pClient = alloc_taobao_client(url, appkey, appsecret);
set_api_name(pRequest,"alibaba.idle.isv.item.query");
add_param(pRequest,"param","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,sessionKey);
printf("ret code:%d\n",pResponse->code);
if(pResponse->code == 0){
	pTopResponseIterator ite = init_response_iterator(pResponse);
	pResultItem pResultItem = alloc_result_item();
	while(parseNext(ite, pResultItem) == 0){
		printf("%s:%s\n",pResultItem->key,pResultItem->value);
	}
	destroy_response_iterator(ite);
	destroy_result_item(pResultItem);
}
destroy_top_request(pRequest);
destroy_top_response(pResponse);
destroy_taobao_client(pClient);

TopClient = require('./topClient').TopClient;
var client = new TopClient({
	'appkey': 'appkey',
	'appsecret': 'secret',
	'REST_URL': 'http://gw.api.taobao.com/router/rest'
});

client.execute('alibaba.idle.isv.item.query', {
	'param':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

响应示例

XML示例
JSON示例

<alibaba_idle_isv_item_query_response>
    <result>
        <data>
            <category_id>32456789</category_id>
            <desc>全新，红色，超便宜</desc>
            <division_id>330110</division_id>
            <img_urls>
                <string>[]</string>
            </img_urls>
            <inspect_report>http://inspect_report.html</inspect_report>
            <item_id>商品id</item_id>
            <original_price>50.02</original_price>
            <reserve_price>35.31</reserve_price>
            <sp_biz_type>1</sp_biz_type>
            <status>0</status>
            <stuff_status>99</stuff_status>
            <title>iphoneX手机特卖</title>
            <trade_type>1</trade_type>
            <transport_fee>5.87</transport_fee>
            <item_biz_type>1</item_biz_type>
            <ware_house_city>杭州</ware_house_city>
            <ware_house_time>1615863262</ware_house_time>
            <item_tags>
                <string>[&quot;TEST&quot;]</string>
            </item_tags>
            <channel_cat_id>12345567</channel_cat_id>
            <pv_list>
                <idle_new_pub_value_do>
                    <property_id>21553</property_id>
                    <property_name>品牌</property_name>
                    <channel_cat_id>1451</channel_cat_id>
                    <value_id>12354</value_id>
                    <value_name>Apple/苹果</value_name>
                </idle_new_pub_value_do>
            </pv_list>
            <item_sku_list>
                <idle_item_api_sku_do>
                    <sku_id>2342345456</sku_id>
                    <quantity>13</quantity>
                    <price>8</price>
                    <property_list>
                        <idle_item_api_pv_pair_do>
                            <property_text>尺码</property_text>
                            <value_text>XL</value_text>
                        </idle_item_api_pv_pair_do>
                    </property_list>
                    <outer_id>32452435456</outer_id>
                    <supply_price>1.0</supply_price>
                    <cspu_id>32452435456</cspu_id>
                </idle_item_api_sku_do>
            </item_sku_list>
            <inspected_data>
                <inspect_report>http://inspect_report.html</inspect_report>
                <ware_house_city>深圳</ware_house_city>
                <ware_house_time>1620544846</ware_house_time>
            </inspected_data>
            <book_data>
                <barcode>9787111302832</barcode>
                <barcode_name>计算机科学丛书</barcode_name>
            </book_data>
            <quantity>10</quantity>
            <outer_id>190085448924</outer_id>
            <template_id>40090611110</template_id>
            <bid_data>
                <bid_item_id>324453452343</bid_item_id>
                <bid_start_time>1630896653000</bid_start_time>
                <bid_end_time>1630896753000</bid_end_time>
                <bid_bail>3200</bid_bail>
                <bid_step>100</bid_step>
                <current_bid_price>56700</current_bid_price>
                <bid_count>35</bid_count>
                <delay_count>2</delay_count>
                <support_task_for_free>1</support_task_for_free>
                <cycle_vendue_data>
                    <cycle_buy_remain_count>5</cycle_buy_remain_count>
                    <cycle_buy_start_time>1629949200000</cycle_buy_start_time>
                    <cycle_buy_end_time>1629953200000</cycle_buy_end_time>
                    <cycle_vendue>1</cycle_vendue>
                    <cycle_buy_activity_id>3478</cycle_buy_activity_id>
                </cycle_vendue_data>
                <direct_buy_price>100</direct_buy_price>
            </bid_data>
            <auction_type>a</auction_type>
            <white_bg_img_urls>
                <string>[]</string>
            </white_bg_img_urls>
            <sp_guarantee>1,2,3</sp_guarantee>
            <distribution_data>
                <product_price>0.5</product_price>
                <product_id>123456</product_id>
                <inv_grade>1</inv_grade>
                <market_site>QIAN_NIU</market_site>
            </distribution_data>
            <after_sales_data>
                <support_sdr_policy>true</support_sdr_policy>
                <support_nfr_policy>false</support_nfr_policy>
                <support_vnr_policy>false</support_vnr_policy>
                <support_fd24hs_policy>false</support_fd24hs_policy>
                <support_fd10ms_policy>false</support_fd10ms_policy>
                <support_fd48hs_policy>false</support_fd48hs_policy>
                <support_gpa_policy>false</support_gpa_policy>
                <support_nfgc_policy>false</support_nfgc_policy>
            </after_sales_data>
            <idle_item_api_auto_recharge_do>
                <template_code>accountInputBox</template_code>
                <template_extra_info>PHONE</template_extra_info>
                <owner>true</owner>
            </idle_item_api_auto_recharge_do>
            <idle_item_yhb_do>
                <use_yhb_service>true</use_yhb_service>
                <settings_preferences>{}</settings_preferences>
            </idle_item_yhb_do>
            <real_car_verify_data>
                <driving_license_info>http://1231231</driving_license_info>
                <driving_license_car_photo>http://1231231</driving_license_car_photo>
                <business_license_front>http://1231231</business_license_front>
                <car_function>营运</car_function>
                <car_vin>123123</car_vin>
            </real_car_verify_data>
            <biz_help_data>
                <first_phase_order_id>123</first_phase_order_id>
            </biz_help_data>
            <flash_sale_do>
                <tag>1</tag>
                <food_pro_date>2024-01-01 00:00:00</food_pro_date>
                <food_expire_date>2024-01-01 00:00:00</food_expire_date>
                <b2c_big_shipper_id>21313</b2c_big_shipper_id>
                <b2c_small_shipper_id>123</b2c_small_shipper_id>
                <b2c_small_shipper_name>小货主</b2c_small_shipper_name>
                <out_sync_item_id>123</out_sync_item_id>
                <out_sync_item_name>测试商品</out_sync_item_name>
                <out_sync_sku_id>123</out_sync_sku_id>
            </flash_sale_do>
            <idle_template_id>123</idle_template_id>
            <property_images>
                <idle_item_sku_image_info_api_d_o>
                    <url>12313</url>
                    <property_text>颜色</property_text>
                    <value_text>红色</value_text>
                </idle_item_sku_image_info_api_d_o>
            </property_images>
            <long_images>
                <idle_item_image_info_api_d_o>
                    <width>12</width>
                    <height>12</height>
                    <url>12</url>
                </idle_item_image_info_api_d_o>
            </long_images>
            <weight>9.97</weight>
            <weight_unit>kg</weight_unit>
            <trendy_pre_sale_do>
                <dep_model>1</dep_model>
                <dep_config>10</dep_config>
                <start_time>1725623518000</start_time>
                <end_time>1725623518000</end_time>
                <g_time>1725623518000</g_time>
            </trendy_pre_sale_do>
            <notify_message>为了保障游戏账号商品交易安全，买家需等待30天才能确认收货</notify_message>
            <brand_bargain>
                <item_stuff>20</item_stuff>
                <produce_date>1725623518000</produce_date>
                <shelf_life>12</shelf_life>
                <supplier>闲鱼测试</supplier>
                <cert_pic_id>1232132131231</cert_pic_id>
                <cert_pic_url>http://1231231</cert_pic_url>
            </brand_bargain>
            <store_group_do>
                <group_id>27033</group_id>
                <group_name>肯德基全国门店</group_name>
            </store_group_do>
            <distribution_item_info>
                <out_sync_item_id>842472706080</out_sync_item_id>
                <product_id>562455585535</product_id>
                <out_sync_item_biz_code>idleDistribution</out_sync_item_biz_code>
                <distributor_user_id>2212935862056</distributor_user_id>
                <source_from>1</source_from>
                <out_supply_id>2217601284340</out_supply_id>
                <primary_channel_code>tmallchaoshipm</primary_channel_code>
                <sub_channel_code>tmallchaoshipm_xianyu</sub_channel_code>
                <out_sync_inventory_grade>1</out_sync_inventory_grade>
                <out_sync_sku_id>5688665204001</out_sync_sku_id>
                <need_stuff_custom>false</need_stuff_custom>
                <stuff_value_id>15994218</stuff_value_id>
                <stuff_value_name>几乎全新</stuff_value_name>
            </distribution_item_info>
            <trendy_chou_shang_do>
                <chou_shang_item>true</chou_shang_item>
                <group_box_id>74001</group_box_id>
                <chou_shang_post_item>false</chou_shang_post_item>
            </trendy_chou_shang_do>
            <item_lease_do>
                <rental_deposit_price_in_cent>1000</rental_deposit_price_in_cent>
            </item_lease_do>
            <sec_kill_time>1744697687762</sec_kill_time>
        </data>
        <err_code>PARAM_ILLEGAL</err_code>
        <err_msg>参数不合法</err_msg>
        <success>false</success>
    </result>
</alibaba_idle_isv_item_query_response>

{
    "alibaba_idle_isv_item_query_response":{
        "result":{
            "data":{
                "category_id":32456789,
                "desc":"全新，红色，超便宜",
                "division_id":330110,
                "img_urls":{
                    "string":[
                        "[]"
                    ]
                },
                "inspect_report":"http:\/\/inspect_report.html",
                "item_id":商品id,
                "original_price":"50.02",
                "reserve_price":"35.31",
                "sp_biz_type":"1",
                "status":0,
                "stuff_status":99,
                "title":"iphoneX手机特卖",
                "trade_type":1,
                "transport_fee":"5.87",
                "item_biz_type":1,
                "ware_house_city":"杭州",
                "ware_house_time":1615863262,
                "item_tags":{
                    "string":[
                        "[\"TEST\"]"
                    ]
                },
                "channel_cat_id":"12345567",
                "pv_list":{
                    "idle_new_pub_value_do":[
                        {
                            "property_id":"21553",
                            "property_name":"品牌",
                            "channel_cat_id":"1451",
                            "value_id":"12354",
                            "value_name":"Apple\/苹果"
                        }
                    ]
                },
                "item_sku_list":{
                    "idle_item_api_sku_do":[
                        {
                            "sku_id":2342345456,
                            "quantity":13,
                            "price":8,
                            "property_list":{
                                "idle_item_api_pv_pair_do":[
                                    {
                                        "property_text":"尺码",
                                        "value_text":"XL"
                                    }
                                ]
                            },
                            "outer_id":"32452435456",
                            "supply_price":"1.0",
                            "cspu_id":32452435456
                        }
                    ]
                },
                "inspected_data":{
                    "inspect_report":"http:\/\/inspect_report.html",
                    "ware_house_city":"深圳",
                    "ware_house_time":1620544846
                },
                "book_data":{
                    "barcode":"9787111302832",
                    "barcode_name":"计算机科学丛书"
                },
                "quantity":10,
                "outer_id":"190085448924",
                "template_id":40090611110,
                "bid_data":{
                    "bid_item_id":324453452343,
                    "bid_start_time":1630896653000,
                    "bid_end_time":1630896753000,
                    "bid_bail":3200,
                    "bid_step":100,
                    "current_bid_price":56700,
                    "bid_count":35,
                    "delay_count":2,
                    "support_task_for_free":1,
                    "cycle_vendue_data":{
                        "cycle_buy_remain_count":5,
                        "cycle_buy_start_time":1629949200000,
                        "cycle_buy_end_time":1629953200000,
                        "cycle_vendue":1,
                        "cycle_buy_activity_id":3478
                    },
                    "direct_buy_price":100
                },
                "auction_type":"a",
                "white_bg_img_urls":{
                    "string":[
                        "[]"
                    ]
                },
                "sp_guarantee":"1,2,3",
                "distribution_data":{
                    "product_price":"0.5",
                    "product_id":"123456",
                    "inv_grade":"1",
                    "market_site":"QIAN_NIU"
                },
                "after_sales_data":{
                    "support_sdr_policy":true,
                    "support_nfr_policy":false,
                    "support_vnr_policy":false,
                    "support_fd24hs_policy":false,
                    "support_fd10ms_policy":false,
                    "support_fd48hs_policy":false,
                    "support_gpa_policy":false,
                    "support_nfgc_policy":false
                },
                "idle_item_api_auto_recharge_do":{
                    "template_code":"accountInputBox",
                    "template_extra_info":"PHONE",
                    "owner":true
                },
                "idle_item_yhb_do":{
                    "use_yhb_service":true,
                    "settings_preferences":"{}"
                },
                "real_car_verify_data":{
                    "driving_license_info":"http:\/\/1231231",
                    "driving_license_car_photo":"http:\/\/1231231",
                    "business_license_front":"http:\/\/1231231",
                    "car_function":"营运",
                    "car_vin":"123123"
                },
                "biz_help_data":{
                    "first_phase_order_id":123
                },
                "flash_sale_do":{
                    "tag":1,
                    "food_pro_date":"2024-01-01 00:00:00",
                    "food_expire_date":"2024-01-01 00:00:00",
                    "b2c_big_shipper_id":"21313",
                    "b2c_small_shipper_id":"123",
                    "b2c_small_shipper_name":"小货主",
                    "out_sync_item_id":123,
                    "out_sync_item_name":"测试商品",
                    "out_sync_sku_id":123
                },
                "idle_template_id":123,
                "property_images":{
                    "idle_item_sku_image_info_api_d_o":[
                        {
                            "url":"12313",
                            "property_text":"颜色",
                            "value_text":"红色"
                        }
                    ]
                },
                "long_images":{
                    "idle_item_image_info_api_d_o":[
                        {
                            "width":12,
                            "height":12,
                            "url":"12"
                        }
                    ]
                },
                "weight":"9.97",
                "weight_unit":"kg",
                "trendy_pre_sale_do":{
                    "dep_model":1,
                    "dep_config":"10",
                    "start_time":"1725623518000",
                    "end_time":"1725623518000",
                    "g_time":"1725623518000"
                },
                "notify_message":"为了保障游戏账号商品交易安全，买家需等待30天才能确认收货",
                "brand_bargain":{
                    "item_stuff":"20",
                    "produce_date":"1725623518000",
                    "shelf_life":"12",
                    "supplier":"闲鱼测试",
                    "cert_pic_id":1232132131231,
                    "cert_pic_url":"http:\/\/1231231"
                },
                "store_group_do":{
                    "group_id":27033,
                    "group_name":"肯德基全国门店"
                },
                "distribution_item_info":{
                    "out_sync_item_id":"842472706080",
                    "product_id":"562455585535",
                    "out_sync_item_biz_code":"idleDistribution",
                    "distributor_user_id":"2212935862056",
                    "source_from":"1",
                    "out_supply_id":"2217601284340",
                    "primary_channel_code":"tmallchaoshipm",
                    "sub_channel_code":"tmallchaoshipm_xianyu",
                    "out_sync_inventory_grade":"1",
                    "out_sync_sku_id":"5688665204001",
                    "need_stuff_custom":false,
                    "stuff_value_id":"15994218",
                    "stuff_value_name":"几乎全新"
                },
                "trendy_chou_shang_do":{
                    "chou_shang_item":true,
                    "group_box_id":"74001",
                    "chou_shang_post_item":false
                },
                "item_lease_do":{
                    "rental_deposit_price_in_cent":"1000"
                },
                "sec_kill_time":1744697687762
            },
            "err_code":"PARAM_ILLEGAL",
            "err_msg":"参数不合法",
            "success":false
        }
    }
}

异常示例

XML示例
JSON示例

<error_response>
    <code>50</code>
    <msg>Remote service error</msg>
    <sub_code>isv.invalid-parameter</sub_code>
    <sub_msg>非法参数</sub_msg>
</error_response>

{
	"error_response":{
		"msg":"Remote service error",
		"code":50,
		"sub_msg":"非法参数",
		"sub_code":"isv.invalid-parameter"
	}
}

错误码解释

错误码	错误描述	解决方案
TOP_BIZ_CHECK_ERROR	业务校验系统繁忙，请稍后再试	业务校验系统繁忙，请稍后再试
TOP_ITEM_QUERY_FAIL	商品查询失败	确认商品id是否正常，或重试
TOP_NOT_CURRENT_INSPECT_ITEM	非当前服务商商品	优品类商品，必须对应服务商平台才能操作
TOP_PARAMS_INVALID	参数不合法	卖家检查参数
TOP_NOT_SELLER	登录用户不是商品卖家	优品类商品，必须卖家本人查询

API工具

API测试工具错误码查询工具 SDK下载

如何获得此API

FAQ

我要提问

返回
顶部

淘宝开放平台

闲鱼已验货

alibaba.idle.isv.item.query (服务商闲鱼商品查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ