淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
item_id	Number	必须	14343		淘宝拍品id

名称	类型	示例值	描述
result	Result4Top	结果输出	结果输出
└ error_code String 错误代码错误代码 └ error_msg String 错误描述错误描述 └ success Boolean 是否调用成功是否调用成功 value ZcAuctionVo 结果结果 └ apply_count Number 10 交保人数 └ bid_count Number 10 出价次数 └ case_no String 案号案号 └ cooperater String 合作机构合作机构 └ end_time String 拍品结束时间拍品结束时间 └ final_price Number 11234 成交价格，精确到分 └ item_id Number 14343 淘宝拍品id └ out_id String 34343 外部合作伙伴的id,创建拍品时传入 └ pic_url String yyyy-MM-dd HH:mm:ss 图片地址 └ publish_time String yyyy-MM-dd HH:mm:ss 拍品发布时间 └ reserve_price Number 1234 保留价 └ start_time String yyyy-MM-dd HH:mm:ss 开始时间 └ status String 正在进行状态:正在进行\|即将开始\|中止\|撤回\|流拍\|已结束 └ title String 拍品标题拍品标题 └ uv_count Number 3 出价人数 └ winner_time String 最终成交时间最终成交时间 └ start_price Number 1200 起拍价（精确到分） └ increase_range Number 200 加价幅度（精确到分） └ freeze_amount Number 100 保证金（精确到分） └ bid_rule_desc String 一人成交竞价规则 └ consult_price Number 12000 评估价（精确到分） └ item_detail_desc String 详情描述详情描述 └ buyer_qualification_list String [] 资质要求列表竞买资质 └ current_price Number 20000 当前价(精确到分) └ project_id Number 123 公告id └ out_item_id String I_123456 外部系统拍品id └ cat_id Number 82973 类目id └ out_winner_id String U_123 外部系统成交人用户id └ stage Number 1 拍品处置阶段可用值：1:第一次拍卖 location_info LocationInfo 地址信息地址信息 └ location String 浙江省杭州市上城区四季青街道杭州钱江新城市民中心详细地址 └ address String 333102 区级地址code（国标地址库） └ coordinate String 120.20984,30.246306 经纬度坐标，以英文逗号分割 └ delivery_mode Number 10 运费模式,10:无需发货，1：买家自提，4：卖家包邮：2：买家到付，3：自定义运费 └ postage String 10 运费（仅运费模式为自定义运费时需要） └ notify_user_num Number 100 提醒人数 └ look_user_num Number 1000 围观人数 └ link_man String 张三联系人 └ mobile_phone String 18888888888 移动电话 └ phone String 0571-88888888 座机 attachment_list Attachment [] 附件列表附件列表 └ url String https://xxx 附件url └ local_file_name String xxx pdf 附件名称 └ number String S_123 资产编号

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionZcProjectDetailResultRequest req = new AuctionZcProjectDetailResultRequest();
req.setItemId(14343L);
AuctionZcProjectDetailResultResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AuctionZcProjectDetailResultRequest req = new AuctionZcProjectDetailResultRequest();
req.ItemId = 14343L;
AuctionZcProjectDetailResultResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AuctionZcProjectDetailResultRequest;
$req->setItemId("14343");
$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=taobao.auction.zc.project.detail.result' \
-d 'partner_id=apidoc' \
-d 'sign=B2AD2FF013D13710ED765F54F81C5C00' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-04+00%3A06%3A33' \
-d 'v=2.0' \
-d 'item_id=14343'

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

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

req.item_id=14343
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,"taobao.auction.zc.project.detail.result");
add_param(pRequest,"item_id","14343");
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('taobao.auction.zc.project.detail.result', {
	'item_id':'14343'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<auction_zc_project_detail_result_response>
    <result>
        <error_code>错误代码</error_code>
        <error_msg>错误描述</error_msg>
        <success>是否调用成功</success>
        <value>
            <apply_count>10</apply_count>
            <bid_count>10</bid_count>
            <case_no>案号</case_no>
            <cooperater>合作机构</cooperater>
            <end_time>拍品结束时间</end_time>
            <final_price>11234</final_price>
            <item_id>14343</item_id>
            <out_id>34343</out_id>
            <pic_url>yyyy-MM-dd HH:mm:ss</pic_url>
            <publish_time>yyyy-MM-dd HH:mm:ss</publish_time>
            <reserve_price>1234</reserve_price>
            <start_time>yyyy-MM-dd HH:mm:ss</start_time>
            <status>正在进行</status>
            <title>拍品标题</title>
            <uv_count>3</uv_count>
            <winner_time>最终成交时间</winner_time>
            <start_price>1200</start_price>
            <increase_range>200</increase_range>
            <freeze_amount>100</freeze_amount>
            <bid_rule_desc>一人成交</bid_rule_desc>
            <consult_price>12000</consult_price>
            <item_detail_desc>详情描述</item_detail_desc>
            <buyer_qualification_list>
                <string>资质要求列表</string>
            </buyer_qualification_list>
            <current_price>20000</current_price>
            <project_id>123</project_id>
            <out_item_id>I_123456</out_item_id>
            <cat_id>82973</cat_id>
            <out_winner_id>U_123</out_winner_id>
            <stage>1</stage>
            <location_info>
                <location>浙江省杭州市上城区四季青街道杭州钱江新城市民中心</location>
                <address>333102</address>
                <coordinate>120.20984,30.246306</coordinate>
            </location_info>
            <delivery_mode>10</delivery_mode>
            <postage>10</postage>
            <notify_user_num>100</notify_user_num>
            <look_user_num>1000</look_user_num>
            <link_man>张三</link_man>
            <mobile_phone>18888888888</mobile_phone>
            <phone>0571-88888888</phone>
            <attachment_list>
                <attachment>
                    <url>https://xxx</url>
                    <local_file_name>xxx pdf</local_file_name>
                </attachment>
            </attachment_list>
            <number>S_123</number>
        </value>
    </result>
</auction_zc_project_detail_result_response>

{
    "auction_zc_project_detail_result_response":{
        "result":{
            "error_code":"错误代码",
            "error_msg":"错误描述",
            "success":是否调用成功,
            "value":{
                "apply_count":10,
                "bid_count":10,
                "case_no":"案号",
                "cooperater":"合作机构",
                "end_time":"拍品结束时间",
                "final_price":11234,
                "item_id":14343,
                "out_id":"34343",
                "pic_url":"yyyy-MM-dd HH:mm:ss",
                "publish_time":"yyyy-MM-dd HH:mm:ss",
                "reserve_price":1234,
                "start_time":"yyyy-MM-dd HH:mm:ss",
                "status":"正在进行",
                "title":"拍品标题",
                "uv_count":3,
                "winner_time":"最终成交时间",
                "start_price":1200,
                "increase_range":200,
                "freeze_amount":100,
                "bid_rule_desc":"一人成交",
                "consult_price":12000,
                "item_detail_desc":"详情描述",
                "buyer_qualification_list":{
                    "string":[
                        "资质要求列表"
                    ]
                },
                "current_price":20000,
                "project_id":123,
                "out_item_id":"I_123456",
                "cat_id":82973,
                "out_winner_id":"U_123",
                "stage":1,
                "location_info":{
                    "location":"浙江省杭州市上城区四季青街道杭州钱江新城市民中心",
                    "address":"333102",
                    "coordinate":"120.20984,30.246306"
                },
                "delivery_mode":10,
                "postage":"10",
                "notify_user_num":100,
                "look_user_num":1000,
                "link_man":"张三",
                "mobile_phone":"18888888888",
                "phone":"0571-88888888",
                "attachment_list":{
                    "attachment":[
                        {
                            "url":"https:\/\/xxx",
                            "local_file_name":"xxx pdf"
                        }
                    ]
                },
                "number":"S_123"
            }
        }
    }
}

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下载

开放平台

拍卖API

taobao.auction.zc.project.detail.result (查询标的详细信息老版即将下线)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

开放平台

拍卖API

taobao.auction.zc.project.detail.result (查询标的详细信息 老版即将下线)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ

taobao.auction.zc.project.detail.result (查询标的详细信息老版即将下线)