淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
app_id	String	可选	xxxxx		appId
suit_id	Number	可选	3		suitId

名称	类型	示例值	描述
service_result	ServiceResult		serviceResult
content RefereeRegistrationModel 响应结果 └ suit_id Number 3 案件ID └ registration_id Number 3 诉讼系统裁判登记信息 └ entrust_id Number 3 委托ID └ calling_time Date 2000-01-01 00:00:00 接口调用时间 └ received_time Date 2000-01-01 00:00:00 接收时间 └ judgement_result String xxxxx 判决结果 └ judgement_result_second String xxxxx 判决结果二级 └ business_label_keys String xxxxx 业务标签Keys └ other_business_label String xxxxx 其他业务标签内容 └ typical_cause String xxxxx 撤诉原因(原因) └ main_point String xxxxx 要点 └ is_court_opened String xxxxx 是否已开庭 └ is_assume_responsibility String xxxxx 平台是否需要承担责任 └ processor String xxxxx 我方处理人 └ amount BigDecimal 10000.12 诉讼金额 └ amount_our_give BigDecimal 10000.12 判决金额（我方赔付） └ amount_our_receive BigDecimal 10000.12 判决金额（我方获赔） └ defendant_receive BigDecimal 10000.12 判决金额（其他被告赔付） └ founder String xxxxx 创建人 └ updater String xxxxx 更新人 └ create_time Date 2000-01-01 00:00:00 创建时间 └ update_time Date 2000-01-01 00:00:00 更新时间 └ feedback_id Number 3 反馈ID └ feedback_content String xxxxx 反馈内容 feedback_attachment_list FileModel [] 反馈附件 └ key String xxxxx 文件ID └ name String xxxxx 文件名 └ create_time Date 2000-01-01 00:00:00 上传时间 mediation_certificate_files FileModel [] 调解凭证附件列表 └ key String xxxxx 文件ID └ name String xxxxx 文件名 └ create_time Date 2000-01-01 00:00:00 上传时间 written_verdict_files FileModel [] 裁定书附件列表 └ key String xxxxx 文件ID └ name String xxxxx 文件名 └ create_time Date 2000-01-01 00:00:00 上传时间 settlement_agree_files FileModel [] 和解协议附件列表 └ key String xxxxx 文件ID └ name String xxxxx 文件名 └ create_time Date 2000-01-01 00:00:00 上传时间 judge_files FileModel [] 裁决书附件列表 └ key String xxxxx 文件ID └ name String xxxxx 文件名 └ create_time Date 2000-01-01 00:00:00 上传时间 dropped_files FileModel [] 撤诉文件附件列表 └ key String xxxxx 文件ID └ name String xxxxx 文件名 └ create_time Date 2000-01-01 00:00:00 上传时间 other_files FileModel [] 其他附件附件列表 └ key String xxxxx 文件ID └ name String xxxxx 文件名 └ create_time Date 2000-01-01 00:00:00 上传时间 └ drop_date Date 2000-01-01 00:00:00 撤诉日期 └ operation_type String xxxxx 操作类型 └ result_from String xxxxx 来源 └ carry_out String xxxxx 是否需要我方履行 └ success Boolean false 是否成功 └ error_code String xxxxx 错误编码 └ error_msg String xxxxx 错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaTekilikRegistrationGetrefereeregistrationRequest req = new AlibabaTekilikRegistrationGetrefereeregistrationRequest();
req.setAppId("xxxxx");
req.setSuitId(3L);
AlibabaTekilikRegistrationGetrefereeregistrationResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaTekilikRegistrationGetrefereeregistrationRequest req = new AlibabaTekilikRegistrationGetrefereeregistrationRequest();
req.AppId = "xxxxx";
req.SuitId = 3L;
AlibabaTekilikRegistrationGetrefereeregistrationResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaTekilikRegistrationGetrefereeregistrationRequest;
$req->setAppId("xxxxx");
$req->setSuitId("3");
$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=alibaba.tekilik.registration.getrefereeregistration' \
-d 'partner_id=apidoc' \
-d 'sign=2D2170AD8613E248233FACE440B2F892' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-05-14+20%3A53%3A57' \
-d 'v=2.0' \
-d 'app_id=xxxxx' \
-d 'suit_id=3'

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

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

req.app_id="xxxxx"
req.suit_id=3
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,"alibaba.tekilik.registration.getrefereeregistration");
add_param(pRequest,"app_id","xxxxx");
add_param(pRequest,"suit_id","3");
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('alibaba.tekilik.registration.getrefereeregistration', {
	'app_id':'xxxxx',
	'suit_id':'3'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_tekilik_registration_getrefereeregistration_response>
    <service_result>
        <content>
            <suit_id>3</suit_id>
            <registration_id>3</registration_id>
            <entrust_id>3</entrust_id>
            <calling_time>2000-01-01 00:00:00</calling_time>
            <received_time>2000-01-01 00:00:00</received_time>
            <judgement_result>xxxxx</judgement_result>
            <judgement_result_second>xxxxx</judgement_result_second>
            <business_label_keys>xxxxx</business_label_keys>
            <other_business_label>xxxxx</other_business_label>
            <typical_cause>xxxxx</typical_cause>
            <main_point>xxxxx</main_point>
            <is_court_opened>xxxxx</is_court_opened>
            <is_assume_responsibility>xxxxx</is_assume_responsibility>
            <processor>xxxxx</processor>
            <amount>10000.12</amount>
            <amount_our_give>10000.12</amount_our_give>
            <amount_our_receive>10000.12</amount_our_receive>
            <defendant_receive>10000.12</defendant_receive>
            <founder>xxxxx</founder>
            <updater>xxxxx</updater>
            <create_time>2000-01-01 00:00:00</create_time>
            <update_time>2000-01-01 00:00:00</update_time>
            <feedback_id>3</feedback_id>
            <feedback_content>xxxxx</feedback_content>
            <feedback_attachment_list>
                <file_model>
                    <key>xxxxx</key>
                    <name>xxxxx</name>
                    <create_time>2000-01-01 00:00:00</create_time>
                </file_model>
            </feedback_attachment_list>
            <mediation_certificate_files>
                <file_model>
                    <key>xxxxx</key>
                    <name>xxxxx</name>
                    <create_time>2000-01-01 00:00:00</create_time>
                </file_model>
            </mediation_certificate_files>
            <written_verdict_files>
                <file_model>
                    <key>xxxxx</key>
                    <name>xxxxx</name>
                    <create_time>2000-01-01 00:00:00</create_time>
                </file_model>
            </written_verdict_files>
            <settlement_agree_files>
                <file_model>
                    <key>xxxxx</key>
                    <name>xxxxx</name>
                    <create_time>2000-01-01 00:00:00</create_time>
                </file_model>
            </settlement_agree_files>
            <judge_files>
                <file_model>
                    <key>xxxxx</key>
                    <name>xxxxx</name>
                    <create_time>2000-01-01 00:00:00</create_time>
                </file_model>
            </judge_files>
            <dropped_files>
                <file_model>
                    <key>xxxxx</key>
                    <name>xxxxx</name>
                    <create_time>2000-01-01 00:00:00</create_time>
                </file_model>
            </dropped_files>
            <other_files>
                <file_model>
                    <key>xxxxx</key>
                    <name>xxxxx</name>
                    <create_time>2000-01-01 00:00:00</create_time>
                </file_model>
            </other_files>
            <drop_date>2000-01-01 00:00:00</drop_date>
            <operation_type>xxxxx</operation_type>
            <result_from>xxxxx</result_from>
            <carry_out>xxxxx</carry_out>
        </content>
        <success>false</success>
        <error_code>xxxxx</error_code>
        <error_msg>xxxxx</error_msg>
    </service_result>
</alibaba_tekilik_registration_getrefereeregistration_response>

{
    "alibaba_tekilik_registration_getrefereeregistration_response":{
        "service_result":{
            "content":{
                "suit_id":3,
                "registration_id":3,
                "entrust_id":3,
                "calling_time":"2000-01-01 00:00:00",
                "received_time":"2000-01-01 00:00:00",
                "judgement_result":"xxxxx",
                "judgement_result_second":"xxxxx",
                "business_label_keys":"xxxxx",
                "other_business_label":"xxxxx",
                "typical_cause":"xxxxx",
                "main_point":"xxxxx",
                "is_court_opened":"xxxxx",
                "is_assume_responsibility":"xxxxx",
                "processor":"xxxxx",
                "amount":"10000.12",
                "amount_our_give":"10000.12",
                "amount_our_receive":"10000.12",
                "defendant_receive":"10000.12",
                "founder":"xxxxx",
                "updater":"xxxxx",
                "create_time":"2000-01-01 00:00:00",
                "update_time":"2000-01-01 00:00:00",
                "feedback_id":3,
                "feedback_content":"xxxxx",
                "feedback_attachment_list":{
                    "file_model":[
                        {
                            "key":"xxxxx",
                            "name":"xxxxx",
                            "create_time":"2000-01-01 00:00:00"
                        }
                    ]
                },
                "mediation_certificate_files":{
                    "file_model":[
                        {
                            "key":"xxxxx",
                            "name":"xxxxx",
                            "create_time":"2000-01-01 00:00:00"
                        }
                    ]
                },
                "written_verdict_files":{
                    "file_model":[
                        {
                            "key":"xxxxx",
                            "name":"xxxxx",
                            "create_time":"2000-01-01 00:00:00"
                        }
                    ]
                },
                "settlement_agree_files":{
                    "file_model":[
                        {
                            "key":"xxxxx",
                            "name":"xxxxx",
                            "create_time":"2000-01-01 00:00:00"
                        }
                    ]
                },
                "judge_files":{
                    "file_model":[
                        {
                            "key":"xxxxx",
                            "name":"xxxxx",
                            "create_time":"2000-01-01 00:00:00"
                        }
                    ]
                },
                "dropped_files":{
                    "file_model":[
                        {
                            "key":"xxxxx",
                            "name":"xxxxx",
                            "create_time":"2000-01-01 00:00:00"
                        }
                    ]
                },
                "other_files":{
                    "file_model":[
                        {
                            "key":"xxxxx",
                            "name":"xxxxx",
                            "create_time":"2000-01-01 00:00:00"
                        }
                    ]
                },
                "drop_date":"2000-01-01 00:00:00",
                "operation_type":"xxxxx",
                "result_from":"xxxxx",
                "carry_out":"xxxxx"
            },
            "success":false,
            "error_code":"xxxxx",
            "error_msg":"xxxxx"
        }
    }
}

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

alibaba.tekilik.registration.getrefereeregistration (查询裁判登记信息)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ