淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	描述
user_nick	String	必须	淘宝账号	淘宝账号
org_asset_clue_query	OrgAssetClueQuery	必须		线索条件查询对象
└ current_page Number 必须 1 页码 └ page_size Number 必须 10 每页条数 └ clue_type Number 必须 2 案件线索类型，1 保全案件，2诉讼案件，3破产强清案件 └ monitor_id Number 可选 12312 监控对象id（监控id和证件号至少有一个不为空） └ object_number String 可选 SDF232SDF 证件号,企业统一社会信用代码，自然人身份证号 └ object_name String 可选 XXX 监控对象名称 └ case_no String 可选 (20xx)豫民事01号案号 └ remarks String 可选备注A 备注 └ monitor_sign String 可选编号1 监控对象编号 └ find_start_time String 可选 2022-12-12 发现开始时间（yyyy-MM-dd） └ find_end_time String 可选 2022-12-13 发现结束时间（yyyy-MM-dd）

名称	类型	示例值	描述
total_item	Number	118	总条数
total_page	Number	12	总页数
page_size	Number	10	每页条数
current_page	Number	2	当前页数
results	CaseClueVO []		案件数据列表
└ object_name String xxx公司监控对象名称 └ object_number String SF123123 证件号 └ object_type Number 1 监控对象类型1 └ type_desc String 企业监控对象类型描述 └ remarks String 备注A 备注 └ monitor_sign String 编号1 监控对象编号（用于脱敏后区分对象） └ find_time String 2023.04.24 17:00 发现时间 └ case_no String 20xx 案号 └ deal_court String xxx法院经办法院 └ case_progress String 已结案案件进展，已结案和未结案 └ location String 湖南省所在地 └ filing_time String 2017.02.14 立案时间 └ close_time String 2017.02.14 结案时间 └ close_mode String 转为其他案件结案方式 └ litigation_status String 被申请人诉讼地位 └ relation_case_no String (20xx)湘01xx民初xx号关联案件号 └ case_type String 民事一审案件类型 └ case_process String 一审审理程序 └ filing_reason String 合同纠纷立案案由 └ filing_tag String 纠纷立案案由标签 └ case_reason_detail String 合同、准合同纠纷立案案由详细 └ sue_item_amount_level Number 5 起诉标的金额等级 └ sue_item_amount BigDecimal 41000.13 起诉标的金额 └ sue_item_amount_estimate_level Number 5 起诉标的金额估计等级 └ sue_item_amount_estimate BigDecimal 41000.2 起诉标的金额估计 └ trial_mode_info String 北盛法庭,1 审理方式信息 └ close_reason String 合同纠纷结案案由 └ close_tag String 纠纷结案标签 └ close_reason_detail String xxxx 结案案由详细 └ convictions String 纠纷打人定罪罪名 └ convictions_detail String 因合同纠纷打人，致人伤亡定罪罪名详细 └ sentence_result String 罚款300 判处结果 └ close_item_amount_level Number 4 结案标的金额等级 └ close_item_amount BigDecimal 40000.1 结案标的金额 └ close_item_amount_estimate_level Number 4 结案标的金额估计等级 └ close_item_amount_estimate BigDecimal 41001.2 结案标的金额估计 └ victory_estimate String 胜诉胜诉估计 └ first_instance_position String 被申请人一审诉讼地位 └ apply_preservation_amount_level Number 4 申请保全数额等级 └ apply_preservation_amount BigDecimal 42111.1 申请保全数额 └ apply_preservation_object String xxx物品申请保全标的物 └ party String xxx 当事人 └ judgement_result String xxx 判决结果
result_code	String	PACKAGE_EXPIRE	结果code
result_msg	String	机构套餐过期，及时续期	结果信息描述

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionZcRadarCasecluePagequeryRequest req = new AuctionZcRadarCasecluePagequeryRequest();
req.setUserNick("淘宝账号");
AuctionZcRadarCasecluePagequeryRequest.OrgAssetClueQuery obj1 = new AuctionZcRadarCasecluePagequeryRequest.OrgAssetClueQuery();
obj1.setCurrentPage(1L);
obj1.setPageSize(10L);
obj1.setClueType(2L);
obj1.setMonitorId(12312L);
obj1.setObjectNumber("SDF232SDF");
obj1.setObjectName("XXX");
obj1.setCaseNo("(20xx)豫民事01号");
obj1.setRemarks("备注A");
obj1.setMonitorSign("编号1");
obj1.setFindStartTime("2022-12-12");
obj1.setFindEndTime("2022-12-13");
req.setOrgAssetClueQuery(obj1);
AuctionZcRadarCasecluePagequeryResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AuctionZcRadarCasecluePagequeryRequest req = new AuctionZcRadarCasecluePagequeryRequest();
req.UserNick = "淘宝账号";
AuctionZcRadarCasecluePagequeryRequest.OrgAssetClueQueryDomain obj1 = new AuctionZcRadarCasecluePagequeryRequest.OrgAssetClueQueryDomain();
obj1.CurrentPage = 1L;
obj1.PageSize = 10L;
obj1.ClueType = 2L;
obj1.MonitorId = 12312L;
obj1.ObjectNumber = "SDF232SDF";
obj1.ObjectName = "XXX";
obj1.CaseNo = "(20xx)豫民事01号";
obj1.Remarks = "备注A";
obj1.MonitorSign = "编号1";
obj1.FindStartTime = "2022-12-12";
obj1.FindEndTime = "2022-12-13";
req.OrgAssetClueQuery_ = obj1;
AuctionZcRadarCasecluePagequeryResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AuctionZcRadarCasecluePagequeryRequest;
$req->setUserNick("淘宝账号");
$org_asset_clue_query = new OrgAssetClueQuery;
$org_asset_clue_query->current_page="1";
$org_asset_clue_query->page_size="10";
$org_asset_clue_query->clue_type="2";
$org_asset_clue_query->monitor_id="12312";
$org_asset_clue_query->object_number="SDF232SDF";
$org_asset_clue_query->object_name="XXX";
$org_asset_clue_query->case_no="(20xx)豫民事01号";
$org_asset_clue_query->remarks="备注A";
$org_asset_clue_query->monitor_sign="编号1";
$org_asset_clue_query->find_start_time="2022-12-12";
$org_asset_clue_query->find_end_time="2022-12-13";
$req->setOrgAssetClueQuery(json_encode($org_asset_clue_query));
$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.radar.caseclue.pagequery' \
-d 'partner_id=apidoc' \
-d 'sign=FCD51BBD4442D9F628F71A565B5B185D' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-03+23%3A39%3A39' \
-d 'v=2.0' \
-d 'org_asset_clue_query=null' \
-d 'user_nick=%E6%B7%98%E5%AE%9D%E8%B4%A6%E5%8F%B7'

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

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

req.user_nick="淘宝账号"
req.org_asset_clue_query="数据结构示例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,"taobao.auction.zc.radar.caseclue.pagequery");
add_param(pRequest,"user_nick","淘宝账号");
add_param(pRequest,"org_asset_clue_query","数据结构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('taobao.auction.zc.radar.caseclue.pagequery', {
	'user_nick':'淘宝账号',
	'org_asset_clue_query':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<auction_zc_radar_caseclue_pagequery_response>
    <total_item>118</total_item>
    <total_page>12</total_page>
    <page_size>10</page_size>
    <current_page>2</current_page>
    <results>
        <case_clue_v_o>
            <object_name>xxx公司</object_name>
            <object_number>SF123123</object_number>
            <object_type>1</object_type>
            <type_desc>企业</type_desc>
            <remarks>备注A</remarks>
            <monitor_sign>编号1</monitor_sign>
            <find_time>2023.04.24 17:00</find_time>
            <case_no>20xx</case_no>
            <deal_court>xxx法院</deal_court>
            <case_progress>已结案</case_progress>
            <location>湖南省</location>
            <filing_time>2017.02.14</filing_time>
            <close_time>2017.02.14</close_time>
            <close_mode>转为其他案件</close_mode>
            <litigation_status>被申请人</litigation_status>
            <relation_case_no>(20xx)湘01xx民初xx号</relation_case_no>
            <case_type>民事一审</case_type>
            <case_process>一审</case_process>
            <filing_reason>合同纠纷</filing_reason>
            <filing_tag>纠纷</filing_tag>
            <case_reason_detail>合同、准合同纠纷</case_reason_detail>
            <sue_item_amount_level>5</sue_item_amount_level>
            <sue_item_amount>41000.13</sue_item_amount>
            <sue_item_amount_estimate_level>5</sue_item_amount_estimate_level>
            <sue_item_amount_estimate>41000.2</sue_item_amount_estimate>
            <trial_mode_info>北盛法庭,1</trial_mode_info>
            <close_reason>合同纠纷</close_reason>
            <close_tag>纠纷</close_tag>
            <close_reason_detail>xxxx</close_reason_detail>
            <convictions>纠纷打人</convictions>
            <convictions_detail>因合同纠纷打人，致人伤亡</convictions_detail>
            <sentence_result>罚款300</sentence_result>
            <close_item_amount_level>4</close_item_amount_level>
            <close_item_amount>40000.1</close_item_amount>
            <close_item_amount_estimate_level>4</close_item_amount_estimate_level>
            <close_item_amount_estimate>41001.2</close_item_amount_estimate>
            <victory_estimate>胜诉</victory_estimate>
            <first_instance_position>被申请人</first_instance_position>
            <apply_preservation_amount_level>4</apply_preservation_amount_level>
            <apply_preservation_amount>42111.1</apply_preservation_amount>
            <apply_preservation_object>xxx物品</apply_preservation_object>
            <party>xxx</party>
            <judgement_result>xxx</judgement_result>
        </case_clue_v_o>
    </results>
    <result_code>PACKAGE_EXPIRE</result_code>
    <result_msg>机构套餐过期，及时续期</result_msg>
</auction_zc_radar_caseclue_pagequery_response>

{
    "auction_zc_radar_caseclue_pagequery_response":{
        "total_item":118,
        "total_page":12,
        "page_size":10,
        "current_page":2,
        "results":{
            "case_clue_v_o":[
                {
                    "object_name":"xxx公司",
                    "object_number":"SF123123",
                    "object_type":1,
                    "type_desc":"企业",
                    "remarks":"备注A",
                    "monitor_sign":"编号1",
                    "find_time":"2023.04.24 17:00",
                    "case_no":"20xx",
                    "deal_court":"xxx法院",
                    "case_progress":"已结案",
                    "location":"湖南省",
                    "filing_time":"2017.02.14",
                    "close_time":"2017.02.14",
                    "close_mode":"转为其他案件",
                    "litigation_status":"被申请人",
                    "relation_case_no":"(20xx)湘01xx民初xx号",
                    "case_type":"民事一审",
                    "case_process":"一审",
                    "filing_reason":"合同纠纷",
                    "filing_tag":"纠纷",
                    "case_reason_detail":"合同、准合同纠纷",
                    "sue_item_amount_level":5,
                    "sue_item_amount":"41000.13",
                    "sue_item_amount_estimate_level":5,
                    "sue_item_amount_estimate":"41000.2",
                    "trial_mode_info":"北盛法庭,1",
                    "close_reason":"合同纠纷",
                    "close_tag":"纠纷",
                    "close_reason_detail":"xxxx",
                    "convictions":"纠纷打人",
                    "convictions_detail":"因合同纠纷打人，致人伤亡",
                    "sentence_result":"罚款300",
                    "close_item_amount_level":4,
                    "close_item_amount":"40000.1",
                    "close_item_amount_estimate_level":4,
                    "close_item_amount_estimate":"41001.2",
                    "victory_estimate":"胜诉",
                    "first_instance_position":"被申请人",
                    "apply_preservation_amount_level":4,
                    "apply_preservation_amount":"42111.1",
                    "apply_preservation_object":"xxx物品",
                    "party":"xxx",
                    "judgement_result":"xxx"
                }
            ]
        },
        "result_code":"PACKAGE_EXPIRE",
        "result_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.zc.radar.caseclue.pagequery (竞价雷达案件线索分页查询)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ