淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
merchant_id	Number	必须	1		公告ID

名称	类型	示例值	描述
result	Result4Top	接口返回值	接口返回值
└ error_code String 错误码 value ServiceMnDetailDto 商品详情对象商品详情对象 └ debt_interest String 100 债权利息 └ debt_base_date String 2020-07-06 基准日 └ debt_borrower_name String 张三债务人名称 └ debt_borrowers String 地区：新疆债务人情况 guarantor_list GuarantorList [] 保证人列表保证人列表 └ name String 李四保证人名称 └ desc String 保证人情况保证人情况 collateral_list CollateralList [] 抵押物列表抵押物列表 └ asset_type String 资产抵押物类型 └ title String 房屋抵押物名称 └ prov String 安徽抵押物所在地省 └ city String 宣城抵押物所在地市 └ area String 宁国抵押物所在地区县 └ location_detail String 凤凰小区1-101 抵押物所在地详细地址 └ pic_url String http://123.png,http://233.png 抵押物图片 └ detail String 抵押物情况抵押物情况 └ location_code String 341881 地址码，国际标准 └ id Number 123 抵押物id └ original_warrants String 房地权证房产中心字第362619号原始权证 └ other_warrants String 房地权证房产中心字第362619号它项权证 └ building_area String 123.12 建筑面积，单位平米 └ site_area String 57.9 土地面积，单位平米 └ debt_principal String 12312 债权本金 └ guarantee_type String 保证担保方式，枚举值：保证，抵（质）押+保证，抵（质）押，信用 └ detail String 公告详情公告详情 └ pics String http://1.png,http://2.png 公告图片，多个图片以英文逗号分隔 └ title String 测试公告公告标题 └ area String 宁国所在地区县 └ city String 宣城所在地市 └ prov String 安徽所在地省 └ type_name String 机动车资产类型，枚举值：土地林权，机动车，机械设备，知识产权，无形资产，其他资产，债权，股权，房产，通信设备，农资，奢侈品，蓄电池，线缆，IT设备，铁件，空调，综合办公，大宗原材料，家电 └ upper_price String 20000 参考价值上限，单位：元 └ lower_price String 1000 参考价值下限，单位：元 └ status_name String 编辑中状态名称：编辑中，招商中，已转竞价，线下已处理，已过期，已撤回，已删除 └ org_name String 浙江百里公司机构名称 └ location_code String 103418 地理位置码，国际标准 └ pv Number 6 围观人数 contact_list Contact [] 联系人列表 └ name String 张三姓名 └ phone String 13334343232 联系方式(固定电话或手机) └ property_type Number 1 项目类型 1国有资产 2普通资产 4涉案资产 5涉公资产 7金融资产 8破产资产 9集体资产 10多元解纷资产 attach_list MnAttachDTO [] 附件列表 └ name String 阿里询价报告.pdf 附件名称 └ download_url String https://sf.taobao.com/zc/mn_attach_download.do?url=xxx 下载链接 └ summary String 摘要信息摘要 └ litigation_no String （2016）诉审字第001号执行案号/诉讼案号 └ pub_time Date 2022-01-01 00:00:00 发布时间 └ start_time Date 2022-01-01 00:00:00 开始时间 └ end_time Date 2022-01-31 23:59:59 结束时间 └ status Number 2 状态码：1 编辑中，2 招商中，3 已转竞价，4 线下已处理，5 已过期 6 已撤回，-1 已删除 └ other_fee String 1.5 债权其他费用 └ asset_package Boolean true 债权形态 true 债权包 false 单笔债权 └ multi_currency Boolean false 是否多币种 true 是 false 不是 └ error_msg String 错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionGovMndetailGetRequest req = new AuctionGovMndetailGetRequest();
req.setMerchantId(1L);
AuctionGovMndetailGetResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AuctionGovMndetailGetRequest req = new AuctionGovMndetailGetRequest();
req.MerchantId = 1L;
AuctionGovMndetailGetResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AuctionGovMndetailGetRequest;
$req->setMerchantId("1");
$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.gov.mndetail.get' \
-d 'partner_id=apidoc' \
-d 'sign=E8786E7E0694DB30033756B4876EEB72' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-12-15+03%3A26%3A52' \
-d 'v=2.0' \
-d 'merchant_id=1'

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

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

req.merchant_id=1
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.gov.mndetail.get");
add_param(pRequest,"merchant_id","1");
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.gov.mndetail.get', {
	'merchant_id':'1'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<auction_gov_mndetail_get_response>
    <result>
        <error_code></error_code>
        <value>
            <debt_interest>100</debt_interest>
            <debt_base_date>2020-07-06</debt_base_date>
            <debt_borrower_name>张三</debt_borrower_name>
            <debt_borrowers>地区：新疆</debt_borrowers>
            <guarantor_list>
                <guarantor_list>
                    <name>李四</name>
                    <desc>保证人情况</desc>
                </guarantor_list>
            </guarantor_list>
            <collateral_list>
                <collateral_list>
                    <asset_type>资产</asset_type>
                    <title>房屋</title>
                    <prov>安徽</prov>
                    <city>宣城</city>
                    <area>宁国</area>
                    <location_detail>凤凰小区1-101</location_detail>
                    <pic_url>http://123.png,http://233.png</pic_url>
                    <detail>抵押物情况</detail>
                    <location_code>341881</location_code>
                    <id>123</id>
                    <original_warrants>房地权证房产中心字第362619号</original_warrants>
                    <other_warrants>房地权证房产中心字第362619号</other_warrants>
                    <building_area>123.12</building_area>
                    <site_area>57.9</site_area>
                </collateral_list>
            </collateral_list>
            <debt_principal>12312</debt_principal>
            <guarantee_type>保证</guarantee_type>
            <detail>公告详情</detail>
            <pics>http://1.png,http://2.png</pics>
            <title>测试公告</title>
            <area>宁国</area>
            <city>宣城</city>
            <prov>安徽</prov>
            <type_name>机动车</type_name>
            <upper_price>20000</upper_price>
            <lower_price>1000</lower_price>
            <status_name>编辑中</status_name>
            <org_name>浙江百里公司</org_name>
            <location_code>103418</location_code>
            <pv>6</pv>
            <contact_list>
                <contact>
                    <name>张三</name>
                    <phone>13334343232</phone>
                </contact>
            </contact_list>
            <property_type>1</property_type>
            <attach_list>
                <mn_attach_d_t_o>
                    <name>阿里询价报告.pdf</name>
                    <download_url>https://sf.taobao.com/zc/mn_attach_download.do?url=xxx</download_url>
                </mn_attach_d_t_o>
            </attach_list>
            <summary>摘要信息</summary>
            <litigation_no>（2016）诉审字第001号</litigation_no>
            <pub_time>2022-01-01 00:00:00</pub_time>
            <start_time>2022-01-01 00:00:00</start_time>
            <end_time>2022-01-31 23:59:59</end_time>
            <status>2</status>
            <other_fee>1.5</other_fee>
            <asset_package>true</asset_package>
            <multi_currency>false</multi_currency>
        </value>
        <error_msg></error_msg>
    </result>
</auction_gov_mndetail_get_response>

{
    "auction_gov_mndetail_get_response":{
        "result":{
            "error_code":"",
            "value":{
                "debt_interest":"100",
                "debt_base_date":"2020-07-06",
                "debt_borrower_name":"张三",
                "debt_borrowers":"地区：新疆",
                "guarantor_list":{
                    "guarantor_list":[
                        {
                            "name":"李四",
                            "desc":"保证人情况"
                        }
                    ]
                },
                "collateral_list":{
                    "collateral_list":[
                        {
                            "asset_type":"资产",
                            "title":"房屋",
                            "prov":"安徽",
                            "city":"宣城",
                            "area":"宁国",
                            "location_detail":"凤凰小区1-101",
                            "pic_url":"http:\/\/123.png,http:\/\/233.png",
                            "detail":"抵押物情况",
                            "location_code":"341881",
                            "id":123,
                            "original_warrants":"房地权证房产中心字第362619号",
                            "other_warrants":"房地权证房产中心字第362619号",
                            "building_area":"123.12",
                            "site_area":"57.9"
                        }
                    ]
                },
                "debt_principal":"12312",
                "guarantee_type":"保证",
                "detail":"公告详情",
                "pics":"http:\/\/1.png,http:\/\/2.png",
                "title":"测试公告",
                "area":"宁国",
                "city":"宣城",
                "prov":"安徽",
                "type_name":"机动车",
                "upper_price":"20000",
                "lower_price":"1000",
                "status_name":"编辑中",
                "org_name":"浙江百里公司",
                "location_code":"103418",
                "pv":6,
                "contact_list":{
                    "contact":[
                        {
                            "name":"张三",
                            "phone":"13334343232"
                        }
                    ]
                },
                "property_type":1,
                "attach_list":{
                    "mn_attach_d_t_o":[
                        {
                            "name":"阿里询价报告.pdf",
                            "download_url":"https:\/\/sf.taobao.com\/zc\/mn_attach_download.do?url=xxx"
                        }
                    ]
                },
                "summary":"摘要信息",
                "litigation_no":"（2016）诉审字第001号",
                "pub_time":"2022-01-01 00:00:00",
                "start_time":"2022-01-01 00:00:00",
                "end_time":"2022-01-31 23:59:59",
                "status":2,
                "other_fee":"1.5",
                "asset_package":true,
                "multi_currency":false
            },
            "error_msg":""
        }
    }
}

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.gov.mndetail.get (获取招商公告详情)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ