淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
biz_order_id	Number	必须	1231234		订单号

名称	类型	示例值	描述
error_msg	String	订单查询失败	失败时候错误信息
module	RecycleOrderTo		订单信息
└ app_key String 31123412 回收商appkey └ apprize_amount Number 31000 估价金额,单位分 └ apprize_id String 989123 估价Id └ area String 余杭区 └ biz_order_id String 781293810231231 交易订单号 └ buyer_close_reason String 联系不上用户回收商取消订单原因 └ seller_close_reason String 不想卖了用户取消订单原因 └ buyer_nick String 回收商账户01 回收商买家账号 └ channel String idle 渠道信息 └ channel_data String { "idleBizCode": 70, "weight": "5" } 渠道内的业务数据json格式比如 ship=1 服装类的不需要发货,weight=5-15 代表服装5-15kg, userLevel=vip 代表免议价用户,sellerRealPhone 淘宝账号绑定的手机号 └ city String 杭州城市 └ country String 中泰村 └ coupon_fee String 0 加价券金额,单位分 └ coupon_id String 123 加价券Id（预留） └ coupon_rule String { "actType": 3, "beg": "2017-12-21 16:00:00", "couponFee": 0, "couponId": "-5", "desc": "阶梯价", "end": "2019-02-31 00:00:00", "idleBizCode": "8", "low": 0, "range": [{ "actType": 1, "couponFee": 0, "desc": "100~2000元,加价10%", "low": 10000, "percent": 0.1, "up": 200000 }, { "actType": 1, "couponFee": 0, "desc": "2000~3000元,加价20%", "low": 200000, "percent": 0.2, "up": 300000 }, { "actType": 2, "addFee": 70000, "couponFee": 0, "desc": "3000元以上,加价700", "low": 300000, "up": 0 }] } 加价券规则（预留） └ credit_pay Boolean true true：是信用预付订单，false：普通订单 └ credit_pay_amount Number 10000 信用预付金额,单位分 └ env String online onlien:线上环境 pre：测试环境 └ gmt_create String 2018-02-12 11:32:21 订单创建时间 └ idle_pay_type String 1 1:现金支付 └ order_status Number 1 回收订单状态：1:订单创建 2:已上门取件 3:已质检 4:卖家确认交易完成 6:卖家订单已评价 7:回收商订单已评价 100:卖家申请退回 101:货物已退回 102:卖家关闭订单 └ province String 浙江省省 └ rate_content String 交易顺利卖家评价内容 └ rate_grade String 1 好评,0 默认中评卖家评价等级 └ refund_reason String 报价太低卖家申请退回原因 └ seller_address String 浙江省杭州市余杭区969号卖家收货地址 └ seller_nick String testSeller123 卖家淘宝nick └ seller_phone String 13399120012 卖家联系号码 └ seller_real_name String 王小二卖家真实姓名 └ ship_time String 2018-02-13 12:12:11 上门取件时间 └ ship_type String 取件类型 1：顺风 2：上门取件 3：到店取件类型 └ sub_channel String subShop01 子渠道 └ pay_status String 2 支付状态 1：未付款 2：已付款 └ pay_time String 2018-02-13 12:12:11 下单后付款时间 └ end_time String 2018-02-13 12:12:11 订单完结时间 └ recovery_pay_id String 20889123123 追缴单流水Id └ recovery_pay_time String 2018-02-13 12:12:11 追缴成功时间 └ makeup_pay_id String 20889123123 少补单流水Id └ makeup_pay_time String 2018-02-13 12:12:11 少补成功时间 └ main_pay_id String 20889123123 主订单支付流水Id └ qa_amount Number 120 质检金额,单位分 └ quote_version String 0 估价版本，第几次估价 └ replace_subsidy Boolean true 是否换机补贴 └ pre_fee String 100 预估补贴金额 └ inspect_fee String 100 质检补贴金额 └ actual_fee String 100 实付补贴金额 └ subsidy_pay_id String 215541123 补贴打款支付宝流水号
result	Boolean	true	是否成功

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaIdleRecycleOrderGetRequest req = new AlibabaIdleRecycleOrderGetRequest();
req.setBizOrderId(1231234L);
AlibabaIdleRecycleOrderGetResponse rsp = client.execute(req, sessionKey);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaIdleRecycleOrderGetRequest req = new AlibabaIdleRecycleOrderGetRequest();
req.BizOrderId = 1231234L;
AlibabaIdleRecycleOrderGetResponse rsp = client.Execute(req, sessionKey);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaIdleRecycleOrderGetRequest;
$req->setBizOrderId("1231234");
$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.recycle.order.get' \
-d 'partner_id=apidoc' \
-d 'session=fa3f6bb8-3ee6-4900-9d58-94ad011d402d' \
-d 'sign=C298EA33D67FDD3D7B8061A9D54D82E3' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-04-26+08%3A08%3A59' \
-d 'v=2.0' \
-d 'biz_order_id=1231234'

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

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

req.biz_order_id=1231234
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.recycle.order.get");
add_param(pRequest,"biz_order_id","1231234");
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.recycle.order.get', {
	'biz_order_id':'1231234'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_idle_recycle_order_get_response>
    <error_msg>订单查询失败</error_msg>
    <module>
        <app_key>31123412</app_key>
        <apprize_amount>31000</apprize_amount>
        <apprize_id>989123</apprize_id>
        <area>余杭</area>
        <biz_order_id>781293810231231</biz_order_id>
        <buyer_close_reason>联系不上用户</buyer_close_reason>
        <seller_close_reason>不想卖了</seller_close_reason>
        <buyer_nick>回收商账户01</buyer_nick>
        <channel>idle</channel>
        <channel_data>{   &quot;idleBizCode&quot;: 70,   &quot;weight&quot;: &quot;5&quot; }</channel_data>
        <city>杭州</city>
        <country>中泰</country>
        <coupon_fee>0</coupon_fee>
        <coupon_id>123</coupon_id>
        <coupon_rule>{     &quot;actType&quot;: 3,     &quot;beg&quot;: &quot;2017-12-21 16:00:00&quot;,     &quot;couponFee&quot;: 0,     &quot;couponId&quot;: &quot;-5&quot;,     &quot;desc&quot;: &quot;阶梯价&quot;,     &quot;end&quot;: &quot;2019-02-31 00:00:00&quot;,     &quot;idleBizCode&quot;: &quot;8&quot;,     &quot;low&quot;: 0,     &quot;range&quot;: [{         &quot;actType&quot;: 1,         &quot;couponFee&quot;: 0,         &quot;desc&quot;: &quot;100~2000元,加价10%&quot;,         &quot;low&quot;: 10000,         &quot;percent&quot;: 0.1,         &quot;up&quot;: 200000     },     {         &quot;actType&quot;: 1,         &quot;couponFee&quot;: 0,         &quot;desc&quot;: &quot;2000~3000元,加价20%&quot;,         &quot;low&quot;: 200000,         &quot;percent&quot;: 0.2,         &quot;up&quot;: 300000     },     {         &quot;actType&quot;: 2,         &quot;addFee&quot;: 70000,         &quot;couponFee&quot;: 0,         &quot;desc&quot;: &quot;3000元以上,加价700&quot;,         &quot;low&quot;: 300000,         &quot;up&quot;: 0     }] }</coupon_rule>
        <credit_pay>true</credit_pay>
        <credit_pay_amount>10000</credit_pay_amount>
        <env>online</env>
        <gmt_create>2018-02-12 11:32:21</gmt_create>
        <idle_pay_type>1</idle_pay_type>
        <order_status>1</order_status>
        <province>浙江省</province>
        <rate_content>交易顺利</rate_content>
        <rate_grade>1 好评,0 默认中评</rate_grade>
        <refund_reason>报价太低</refund_reason>
        <seller_address>浙江省杭州市余杭区969号</seller_address>
        <seller_nick>testSeller123</seller_nick>
        <seller_phone>13399120012</seller_phone>
        <seller_real_name>王小二</seller_real_name>
        <ship_time>2018-02-13 12:12:11</ship_time>
        <ship_type>取件类型 1：顺风 2：上门取件 3：到店</ship_type>
        <sub_channel>subShop01</sub_channel>
        <pay_status>2</pay_status>
        <pay_time>2018-02-13 12:12:11</pay_time>
        <end_time>2018-02-13 12:12:11</end_time>
        <recovery_pay_id>20889123123</recovery_pay_id>
        <recovery_pay_time>2018-02-13 12:12:11</recovery_pay_time>
        <makeup_pay_id>20889123123</makeup_pay_id>
        <makeup_pay_time>2018-02-13 12:12:11</makeup_pay_time>
        <main_pay_id>20889123123</main_pay_id>
        <qa_amount>120</qa_amount>
        <quote_version>0</quote_version>
        <replace_subsidy>true</replace_subsidy>
        <pre_fee>100</pre_fee>
        <inspect_fee>100</inspect_fee>
        <actual_fee>100</actual_fee>
        <subsidy_pay_id>215541123</subsidy_pay_id>
    </module>
    <result>true</result>
</alibaba_idle_recycle_order_get_response>

{
    "alibaba_idle_recycle_order_get_response":{
        "error_msg":"订单查询失败",
        "module":{
            "app_key":"31123412",
            "apprize_amount":31000,
            "apprize_id":"989123",
            "area":"余杭",
            "biz_order_id":"781293810231231",
            "buyer_close_reason":"联系不上用户",
            "seller_close_reason":"不想卖了",
            "buyer_nick":"回收商账户01",
            "channel":"idle",
            "channel_data":"{   \"idleBizCode\": 70,   \"weight\": \"5\" }",
            "city":"杭州",
            "country":"中泰",
            "coupon_fee":"0",
            "coupon_id":"123",
            "coupon_rule":"{     \"actType\": 3,     \"beg\": \"2017-12-21 16:00:00\",     \"couponFee\": 0,     \"couponId\": \"-5\",     \"desc\": \"阶梯价\",     \"end\": \"2019-02-31 00:00:00\",     \"idleBizCode\": \"8\",     \"low\": 0,     \"range\": [{         \"actType\": 1,         \"couponFee\": 0,         \"desc\": \"100~2000元,加价10%\",         \"low\": 10000,         \"percent\": 0.1,         \"up\": 200000     },     {         \"actType\": 1,         \"couponFee\": 0,         \"desc\": \"2000~3000元,加价20%\",         \"low\": 200000,         \"percent\": 0.2,         \"up\": 300000     },     {         \"actType\": 2,         \"addFee\": 70000,         \"couponFee\": 0,         \"desc\": \"3000元以上,加价700\",         \"low\": 300000,         \"up\": 0     }] }",
            "credit_pay":true,
            "credit_pay_amount":10000,
            "env":"online",
            "gmt_create":"2018-02-12 11:32:21",
            "idle_pay_type":"1",
            "order_status":1,
            "province":"浙江省",
            "rate_content":"交易顺利",
            "rate_grade":"1 好评,0 默认中评",
            "refund_reason":"报价太低",
            "seller_address":"浙江省杭州市余杭区969号",
            "seller_nick":"testSeller123",
            "seller_phone":"13399120012",
            "seller_real_name":"王小二",
            "ship_time":"2018-02-13 12:12:11",
            "ship_type":"取件类型 1：顺风 2：上门取件 3：到店",
            "sub_channel":"subShop01",
            "pay_status":"2",
            "pay_time":"2018-02-13 12:12:11",
            "end_time":"2018-02-13 12:12:11",
            "recovery_pay_id":"20889123123",
            "recovery_pay_time":"2018-02-13 12:12:11",
            "makeup_pay_id":"20889123123",
            "makeup_pay_time":"2018-02-13 12:12:11",
            "main_pay_id":"20889123123",
            "qa_amount":120,
            "quote_version":"0",
            "replace_subsidy":true,
            "pre_fee":"100",
            "inspect_fee":"100",
            "actual_fee":"100",
            "subsidy_pay_id":"215541123"
        },
        "result":true
    }
}

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

错误码	错误描述	解决方案

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

闲鱼发布

alibaba.idle.recycle.order.get (闲鱼回收订单查询V2)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ