阿里大于 -

请求地址：

环境	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。

名称	类型	是否必须	示例值	更多限制	描述
spuid	Number	必须	12345		闲鱼spuid
questionnaire	String	必须	{"questions":[{"answers":[{"id":111}],"id":11},{"answers":[{"id":123}],"id":12},{"answers":[{"id":132}],"id":13},{"answers":[{"id":142}],"id":14},{"answers":[{"id":151}],"id":15},{"answers":[{"id":163}],"id":16},{"answers":[{"id":173}],"id":17}]}		用户问卷结果
quoteId	Number	必须	1111		报价Id
division	Struct	可选			用户位置信息
└ townId String 可选 33011005 乡镇街道级 └ areaId String 可选 330110 区县级 └ cityId String 可选 330100 市级 └ provinceId String 可选 330000 省级divisionId └ addressDetail String 可选西溪园区A区详细地址 └ area String 可选余杭区区 └ town String 可选文一西路四级地址，比如乡镇 └ city String 可选杭州市市 └ province String 可选浙江省省 └ lat String 可选 80.54 纬度 └ lng String 可选 30.14 经度
userId	String	可选	0		用户id
channel	String	可选	idle		渠道，来源
channelData	String	可选	{"actData":"{\"currentCount\":2,\"desc\":\"20180904中石油分享得全额回收,最高得3次机会\",\"key\":\"1189123_20180904\",\"maxCount\":3}","subChannel":"IMchannel"}		渠道内拓展属性,key需要约定例如 subChannel（二级渠道）、actData（活动内数据）
sceneType	String	可选	3C		回收场景 3C数码：3C;大件回收：BULKS,更多见接入文档估价流程定义
recycleSupplierId	String	可选	545749246		手淘商家的淘宝账号id
recycleType	String	可选	2	默认值：1	1：代表ISV回收类型，此场景recycle_supplier_id为空 2：代表商家回收类型，recycle_supplier_id不为空。
quoteVersion	String	可选	0		估价版本，第几次估价
quoteType	String	可选	3		1:实时估价，2:延迟估价，3:无问卷估价
bizType	String	可选	3C		投放业务
lng	String	可选	79.125		经度
lat	String	可选	32.1542		纬度
storeId	String	可选	12		闲鱼门店id
shipType	Number	可选	1		用户估价履约类型
curDivision	Struct	可选			用户当前位置信息
└ lng String 可选 30.14 经度 └ lat String 可选 100.12 纬度 └ province String 可选浙江省省 └ city String 可选杭州市市 └ town String 可选文一西路乡镇街道 └ area String 可选余杭区区 └ addressDetail String 可选西溪园区详细地址 └ provinceId String 可选 330000 省级 └ cityId String 可选 330100 市级 └ areaId String 可选 330110 区县级 └ townId String 可选 33011005 乡镇街道级

名称	类型	示例值	描述
price	String	12300	价格分
quoteId	Number	1111	本次估价id
errCode	String	0	错误码
spuId	Number	3361927	spuid
errMessage	String	OK	错误信息
success	Boolean	true	是否成功报价
timeLimit	Number	1514014215893	报价时限，回收商需要在时限前给出估价，延迟报价使用，实时报价填0，Long值
ext1	String	80000	备注字段，sceneType为帮卖3C（3C_CONSIGNMENT）时,请填写相同机况回收订单价格差,单位为分,精确到元;例如80000;
ext2	String	13900	备注字段，sceneType为帮卖3C（3C_CONSIGNMENT）时,请填写预计下周下跌金额,单位为分,精确到元;例如13900;
shipTypes	Number []		支持当前地区的交付类型 1:顺丰邮寄，2：上门;3：到店
priceDetail	GoldPriceDetailDTO		其他费用相关信息返回
└ quotationFee Number 100 保价费，单位分邮寄&克重<20g返回 └ freightFee Number 100 运费，单位分邮寄&克重<20g返回 └ detectionFee Number 100 每单检测费，单位分 └ goldPrice Number 100 单克金价，单位分 └ handlingFee Number 100 单克手续费，单位分

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

QimenCloudClient client = new DefaultQimenCloudClient(url, appkey, secret);
AlibabaIdleRecycleQuoteGetRequest req = new AlibabaIdleRecycleQuoteGetRequest();
req.setSpuid(12345L);
req.setQuestionnaire("{\"questions\":[{\"answers\":[{\"id\":111}],\"id\":11},{\"answers\":[{\"id\":123}],\"id\":12},{\"answers\":[{\"id\":132}],\"id\":13},{\"answers\":[{\"id\":142}],\"id\":14},{\"answers\":[{\"id\":151}],\"id\":15},{\"answers\":[{\"id\":163}],\"id\":16},{\"answers\":[{\"id\":173}],\"id\":17}]}");
req.setQuoteId(1111L);
AlibabaIdleRecycleQuoteGetRequest.Struct obj1 = new AlibabaIdleRecycleQuoteGetRequest.Struct();
obj1.setTownId("33011005");
obj1.setAreaId("330110");
obj1.setCityId("330100");
obj1.setProvinceId("330000");
obj1.setAddressDetail("西溪园区A区");
obj1.setArea("余杭区");
obj1.setTown("文一西路");
obj1.setCity("杭州市");
obj1.setProvince("浙江省");
obj1.setLat("80.54");
obj1.setLng("30.14");
req.setDivision(obj1);
req.setUserId("0");
req.setChannel("idle");
req.setChannelData("{\"actData\":\"{\\"currentCount\\":2,\\"desc\\":\\"20180904中石油分享得全额回收,最高得3次机会\\",\\"key\\":\\"1189123_20180904\\",\\"maxCount\\":3}\",\"subChannel\":\"IMchannel\"}");
req.setSceneType("3C");
req.setRecycleSupplierId("545749246");
req.setRecycleType("2");
req.setQuoteVersion("0");
req.setQuoteType("3");
req.setBizType("3C");
req.setLng("79.125");
req.setLat("32.1542");
req.setStoreId("12");
req.setShipType(1L);
AlibabaIdleRecycleQuoteGetRequest.Struct obj2 = new AlibabaIdleRecycleQuoteGetRequest.Struct();
obj2.setLng("30.14");
obj2.setLat("100.12");
obj2.setProvince("浙江省");
obj2.setCity("杭州市");
obj2.setTown("文一西路");
obj2.setArea("余杭区");
obj2.setAddressDetail("西溪园区");
obj2.setProvinceId("330000");
obj2.setCityId("330100");
obj2.setAreaId("330110");
obj2.setTownId("33011005");
req.setCurDivision(obj2);
AlibabaIdleRecycleQuoteGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaIdleRecycleQuoteGetRequest req = new AlibabaIdleRecycleQuoteGetRequest();
req.Spuid = 12345L;
req.Questionnaire = "{\"questions\":[{\"answers\":[{\"id\":111}],\"id\":11},{\"answers\":[{\"id\":123}],\"id\":12},{\"answers\":[{\"id\":132}],\"id\":13},{\"answers\":[{\"id\":142}],\"id\":14},{\"answers\":[{\"id\":151}],\"id\":15},{\"answers\":[{\"id\":163}],\"id\":16},{\"answers\":[{\"id\":173}],\"id\":17}]}";
req.QuoteId = 1111L;
AlibabaIdleRecycleQuoteGetRequest.StructDomain obj1 = new AlibabaIdleRecycleQuoteGetRequest.StructDomain();
obj1.TownId = "33011005";
obj1.AreaId = "330110";
obj1.CityId = "330100";
obj1.ProvinceId = "330000";
obj1.AddressDetail = "西溪园区A区";
obj1.Area = "余杭区";
obj1.Town = "文一西路";
obj1.City = "杭州市";
obj1.Province = "浙江省";
obj1.Lat = "80.54";
obj1.Lng = "30.14";
req.Division_ = obj1;
req.UserId = "0";
req.Channel = "idle";
req.ChannelData = "{\"actData\":\"{\\"currentCount\\":2,\\"desc\\":\\"20180904中石油分享得全额回收,最高得3次机会\\",\\"key\\":\\"1189123_20180904\\",\\"maxCount\\":3}\",\"subChannel\":\"IMchannel\"}";
req.SceneType = "3C";
req.RecycleSupplierId = "545749246";
req.RecycleType = "2";
req.QuoteVersion = "0";
req.QuoteType = "3";
req.BizType = "3C";
req.Lng = "79.125";
req.Lat = "32.1542";
req.StoreId = "12";
req.ShipType = 1L;
AlibabaIdleRecycleQuoteGetRequest.StructDomain obj2 = new AlibabaIdleRecycleQuoteGetRequest.StructDomain();
obj2.Lng = "30.14";
obj2.Lat = "100.12";
obj2.Province = "浙江省";
obj2.City = "杭州市";
obj2.Town = "文一西路";
obj2.Area = "余杭区";
obj2.AddressDetail = "西溪园区";
obj2.ProvinceId = "330000";
obj2.CityId = "330100";
obj2.AreaId = "330110";
obj2.TownId = "33011005";
req.CurDivision_ = obj2;
AlibabaIdleRecycleQuoteGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaIdleRecycleQuoteGetRequest;
$req->setSpuid("12345");
$req->setQuestionnaire("{\"questions\":[{\"answers\":[{\"id\":111}],\"id\":11},{\"answers\":[{\"id\":123}],\"id\":12},{\"answers\":[{\"id\":132}],\"id\":13},{\"answers\":[{\"id\":142}],\"id\":14},{\"answers\":[{\"id\":151}],\"id\":15},{\"answers\":[{\"id\":163}],\"id\":16},{\"answers\":[{\"id\":173}],\"id\":17}]}");
$req->setQuoteId("1111");
$division = new Struct;
$division->town_id="33011005";
$division->area_id="330110";
$division->city_id="330100";
$division->province_id="330000";
$division->address_detail="西溪园区A区";
$division->area="余杭区";
$division->town="文一西路";
$division->city="杭州市";
$division->province="浙江省";
$division->lat="80.54";
$division->lng="30.14";
$req->setDivision(json_encode($division));
$req->setUserId("0");
$req->setChannel("idle");
$req->setChannelData("{\"actData\":\"{\\"currentCount\\":2,\\"desc\\":\\"20180904中石油分享得全额回收,最高得3次机会\\",\\"key\\":\\"1189123_20180904\\",\\"maxCount\\":3}\",\"subChannel\":\"IMchannel\"}");
$req->setSceneType("3C");
$req->setRecycleSupplierId("545749246");
$req->setRecycleType("2");
$req->setQuoteVersion("0");
$req->setQuoteType("3");
$req->setBizType("3C");
$req->setLng("79.125");
$req->setLat("32.1542");
$req->setStoreId("12");
$req->setShipType("1");
$curDivision = new Struct;
$curDivision->lng="30.14";
$curDivision->lat="100.12";
$curDivision->province="浙江省";
$curDivision->city="杭州市";
$curDivision->town="文一西路";
$curDivision->area="余杭区";
$curDivision->address_detail="西溪园区";
$curDivision->province_id="330000";
$curDivision->city_id="330100";
$curDivision->area_id="330110";
$curDivision->town_id="33011005";
$req->setCurDivision(json_encode($curDivision));
$resp = $c->execute($req);

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=qimen.alibaba.idle.recycle.quote.get' \
-d 'partner_id=apidoc' \
-d 'sign=F11FDA5AEF83876C8AFB7B741C3BE851' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-27+22%3A36%3A33' \
-d 'v=2.0' \
-d 'bizType=3C' \
-d 'channel=idle' \
-d 'channelData=%7B%5C%22actData%5C%22%3A%5C%22%7B%5C%5C%22currentCount%5C%5C%22%3A2%2C%5C%5C%22desc%5C%5C%22%3A%5C%5C%2220180904%E4%B8%AD%E7%9F%B3%E6%B2%B9%E5%88%86%E4%BA%AB%E5%BE%97%E5%85%A8%E9%A2%9D%E5%9B%9E%E6%94%B6%2C%E6%9C%80%E9%AB%98%E5%BE%973%E6%AC%A1%E6%9C%BA%E4%BC%9A%5C%5C%22%2C%5C%5C%22key%5C%5C%22%3A%5C%5C%221189123_20180904%5C%5C%22%2C%5C%5C%22maxCount%5C%5C%22%3A3%7D%5C%22%2C%5C%22subChannel%5C%22%3A%5C%22IMchannel%5C%22%7D' \
-d 'curDivision=null' \
-d 'division=null' \
-d 'lat=32.1542' \
-d 'lng=79.125' \
-d 'questionnaire=%7B%5C%22questions%5C%22%3A%5B%7B%5C%22answers%5C%22%3A%5B%7B%5C%22id%5C%22%3A111%7D%5D%2C%5C%22id%5C%22%3A11%7D%2C%7B%5C%22answers%5C%22%3A%5B%7B%5C%22id%5C%22%3A123%7D%5D%2C%5C%22id%5C%22%3A12%7D%2C%7B%5C%22answers%5C%22%3A%5B%7B%5C%22id%5C%22%3A132%7D%5D%2C%5C%22id%5C%22%3A13%7D%2C%7B%5C%22answers%5C%22%3A%5B%7B%5C%22id%5C%22%3A142%7D%5D%2C%5C%22id%5C%22%3A14%7D%2C%7B%5C%22answers%5C%22%3A%5B%7B%5C%22id%5C%22%3A151%7D%5D%2C%5C%22id%5C%22%3A15%7D%2C%7B%5C%22answers%5C%22%3A%5B%7B%5C%22id%5C%22%3A163%7D%5D%2C%5C%22id%5C%22%3A16%7D%2C%7B%5C%22answers%5C%22%3A%5B%7B%5C%22id%5C%22%3A173%7D%5D%2C%5C%22id%5C%22%3A17%7D%5D%7D' \
-d 'quoteId=1111' \
-d 'quoteType=3' \
-d 'quoteVersion=0' \
-d 'recycleSupplierId=545749246' \
-d 'recycleType=2' \
-d 'sceneType=3C' \
-d 'shipType=1' \
-d 'spuid=12345' \
-d 'storeId=12' \
-d 'userId=0'

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

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

req.spuid=12345
req.questionnaire="{\"questions\":[{\"answers\":[{\"id\":111}],\"id\":11},{\"answers\":[{\"id\":123}],\"id\":12},{\"answers\":[{\"id\":132}],\"id\":13},{\"answers\":[{\"id\":142}],\"id\":14},{\"answers\":[{\"id\":151}],\"id\":15},{\"answers\":[{\"id\":163}],\"id\":16},{\"answers\":[{\"id\":173}],\"id\":17}]}"
req.quoteId=1111
req.division="数据结构示例JSON格式"
req.userId="0"
req.channel="idle"
req.channelData="{\"actData\":\"{\\"currentCount\\":2,\\"desc\\":\\"20180904中石油分享得全额回收,最高得3次机会\\",\\"key\\":\\"1189123_20180904\\",\\"maxCount\\":3}\",\"subChannel\":\"IMchannel\"}"
req.sceneType="3C"
req.recycleSupplierId="545749246"
req.recycleType="2"
req.quoteVersion="0"
req.quoteType="3"
req.bizType="3C"
req.lng="79.125"
req.lat="32.1542"
req.storeId="12"
req.shipType=1
req.curDivision="数据结构示例JSON格式"
try:
	resp= req.getResponse()
	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,"qimen.alibaba.idle.recycle.quote.get");
add_param(pRequest,"spuid","12345");
add_param(pRequest,"questionnaire","{\"questions\":[{\"answers\":[{\"id\":111}],\"id\":11},{\"answers\":[{\"id\":123}],\"id\":12},{\"answers\":[{\"id\":132}],\"id\":13},{\"answers\":[{\"id\":142}],\"id\":14},{\"answers\":[{\"id\":151}],\"id\":15},{\"answers\":[{\"id\":163}],\"id\":16},{\"answers\":[{\"id\":173}],\"id\":17}]}");
add_param(pRequest,"quoteId","1111");
add_param(pRequest,"division","数据结构JSON示例");
add_param(pRequest,"userId","0");
add_param(pRequest,"channel","idle");
add_param(pRequest,"channelData","{\"actData\":\"{\\"currentCount\\":2,\\"desc\\":\\"20180904中石油分享得全额回收,最高得3次机会\\",\\"key\\":\\"1189123_20180904\\",\\"maxCount\\":3}\",\"subChannel\":\"IMchannel\"}");
add_param(pRequest,"sceneType","3C");
add_param(pRequest,"recycleSupplierId","545749246");
add_param(pRequest,"recycleType","2");
add_param(pRequest,"quoteVersion","0");
add_param(pRequest,"quoteType","3");
add_param(pRequest,"bizType","3C");
add_param(pRequest,"lng","79.125");
add_param(pRequest,"lat","32.1542");
add_param(pRequest,"storeId","12");
add_param(pRequest,"shipType","1");
add_param(pRequest,"curDivision","数据结构JSON示例");
pResponse = top_execute(pClient,pRequest,NULL);
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('qimen.alibaba.idle.recycle.quote.get', {
	'spuid':'12345',
	'questionnaire':'{\"questions\":[{\"answers\":[{\"id\":111}],\"id\":11},{\"answers\":[{\"id\":123}],\"id\":12},{\"answers\":[{\"id\":132}],\"id\":13},{\"answers\":[{\"id\":142}],\"id\":14},{\"answers\":[{\"id\":151}],\"id\":15},{\"answers\":[{\"id\":163}],\"id\":16},{\"answers\":[{\"id\":173}],\"id\":17}]}',
	'quoteId':'1111',
	'division':'数据结构JSON示例',
	'userId':'0',
	'channel':'idle',
	'channelData':'{\"actData\":\"{\\"currentCount\\":2,\\"desc\\":\\"20180904中石油分享得全额回收,最高得3次机会\\",\\"key\\":\\"1189123_20180904\\",\\"maxCount\\":3}\",\"subChannel\":\"IMchannel\"}',
	'sceneType':'3C',
	'recycleSupplierId':'545749246',
	'recycleType':'2',
	'quoteVersion':'0',
	'quoteType':'3',
	'bizType':'3C',
	'lng':'79.125',
	'lat':'32.1542',
	'storeId':'12',
	'shipType':'1',
	'curDivision':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<price>12300</price>
<quoteId>1111</quoteId>
<errCode>0</errCode>
<spuId>3361927</spuId>
<errMessage>OK</errMessage>
<success>true</success>
<timeLimit>1514014215893</timeLimit>
<ext1>80000</ext1>
<ext2>13900</ext2>
<priceDetail>
    <quotationFee>100</quotationFee>
    <freightFee>100</freightFee>
    <detectionFee>100</detectionFee>
    <goldPrice>100</goldPrice>
    <handlingFee>100</handlingFee>
</priceDetail>

{
    "price":"12300",
    "quoteId":1111,
    "errCode":"0",
    "spuId":3361927,
    "errMessage":"OK",
    "success":true,
    "timeLimit":1514014215893,
    "ext1":"80000",
    "ext2":"13900",
    "priceDetail":{
        "quotationFee":100,
        "freightFee":100,
        "detectionFee":100,
        "goldPrice":100,
        "handlingFee":100
    }
}

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"
	}
}

错误码	错误描述	解决方案
isp.http-read-timeout	请求后端HTTP服务响应超时	请商家检查服务端应用是否正常
isp.http-connection-refuse	后端http服务提供方拒绝连接	请商家检查服务器是否正常
sign-check-failure	验签失败	使用正确的验签方式和数据获取方式；使用sdk的，sdk中有相关工具
isp.http-connection-timeout	后端http服务提供方拒绝连接	请商家检查服务是否正常
spu-not-support	不支持此spu/商品未上架	检查该spu的挂载状态下线此spu：将相应的spu挂载状态置为删除或者返回正确的数据。
too_many_queries	业务限流	确认是否是正常业务逻辑
http-service-status-error	后端http服务异常	请商家检查服务是否正常
1026
-1
quote_service_error
quote_spu_not_support
quote_too_many_queries
50
quote_user_punished
arg-check-failure
PARAM_ERROR
ERR_SYS_ERROR
1

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

闲鱼

qimen.alibaba.idle.recycle.quote.get (报价获取)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ