淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
referee_registration_model	RefereeRegistrationModel	可选			裁判登记信息
└ defendant_receive String 可选 23 判决金额（其他被告赔付） └ amount_our_receive String 可选 23 判决金额（我方获赔） └ amount_our_give String 可选 23 判决金额（我方赔付） └ amount String 可选 23 诉讼金额 └ processor String 可选 sz 我方处理人 └ is_assume_responsibility String 可选 y 平台是否需要承担责任 └ is_court_opened String 可选 y 是否已开庭 └ main_point String 可选 ss 要点 └ typical_cause String 可选 cds 撤诉原因(原因) └ other_business_label String 可选 ss 其他业务标签内容 └ business_label_keys String 可选 ss 业务标签Keys └ judgement_result_second String 可选 ss 判决结果二级 └ judgement_result String 可选败诉判决结果 └ received_time Date 可选 2019-04-18 19:04:30 接收时间 └ calling_time Date 可选 2019-04-18 19:04:30 接口调用时间 └ registration_id Number 可选 34 诉讼系统裁判登记信息 └ suit_id Number 可选 23 案件ID └ drop_date String 可选 2019-04-18 19:04:30 撤诉日期 └ feedback_content String 可选 ss 反馈内容 └ feedback_id Number 可选 3 反馈ID └ update_time Date 可选 2019-04-18 19:04:30 更新时间 └ create_time Date 可选 2019-04-18 19:04:30 创建时间 └ updater String 可选 sz 更新人 └ founder String 可选 sz 创建人 dropped_files FileModel [] 可选撤诉文件附件列表 └ name String 可选 cs 附件名称 └ key String 可选 sd 附件key judge_files FileModel [] 可选裁决书附件列表 └ name String 可选 cs 附件名称 └ key String 可选 cd 附件key settlement_agree_files FileModel [] 可选和解协议附件列表 └ name String 可选 cs 附件名称 └ key String 可选 cd 附件key written_verdict_files FileModel [] 可选裁定书附件列表 └ name String 可选 cs 附件名称 └ key String 可选 scsd 附件key mediation_certificate_files FileModel [] 可选调解凭证附件列表 └ name String 可选 cs 附件名称 └ key String 可选 cd 附件key feedback_attachment_list FileModel [] 可选反馈附件 └ name String 可选 csd 附件名称 └ key String 可选 csd 附件key other_files FileModel [] 可选其他附件附件列表 └ name String 可选 dds 附件名称 └ key String 可选 cc 附件key └ entrust_id Number 可选 22 委托ID, └ result_from String 可选平台tag 来源平台 └ operation_type String 可选 ADD 操作类型

名称	类型	示例值	描述
result	ServiceResult	ss	alinkappserver系统返回的通用结果类
└ content Number 34 裁判登记ID └ error_msg String 错误信息系统异常 └ error_code String 错误码 ERR089 └ success Boolean true 是否返回正常

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaLegalSuitJudgementPushRequest req = new AlibabaLegalSuitJudgementPushRequest();
AlibabaLegalSuitJudgementPushRequest.RefereeRegistrationModel obj1 = new AlibabaLegalSuitJudgementPushRequest.RefereeRegistrationModel();
obj1.setDefendantReceive("23");
obj1.setAmountOurReceive("23");
obj1.setAmountOurGive("23");
obj1.setAmount("23");
obj1.setProcessor("sz");
obj1.setIsAssumeResponsibility("y");
obj1.setIsCourtOpened("y");
obj1.setMainPoint("ss");
obj1.setTypicalCause("cds");
obj1.setOtherBusinessLabel("ss");
obj1.setBusinessLabelKeys("ss");
obj1.setJudgementResultSecond("ss");
obj1.setJudgementResult("败诉");
obj1.setReceivedTime(StringUtils.parseDateTime("2019-04-18 19:04:30"));
obj1.setCallingTime(StringUtils.parseDateTime("2019-04-18 19:04:30"));
obj1.setRegistrationId(34L);
obj1.setSuitId(23L);
obj1.setDropDate("2019-04-18 19:04:30");
obj1.setFeedbackContent("ss");
obj1.setFeedbackId(3L);
obj1.setUpdateTime(StringUtils.parseDateTime("2019-04-18 19:04:30"));
obj1.setCreateTime(StringUtils.parseDateTime("2019-04-18 19:04:30"));
obj1.setUpdater("sz");
obj1.setFounder("sz");
List<AlibabaLegalSuitJudgementPushRequest.FileModel> list3 = new ArrayList<AlibabaLegalSuitJudgementPushRequest.FileModel>();
AlibabaLegalSuitJudgementPushRequest.FileModel obj4 = new AlibabaLegalSuitJudgementPushRequest.FileModel();
list3.add(obj4);
obj4.setName("cs");
obj4.setKey("sd");
obj1.setDroppedFiles(list3);
List<AlibabaLegalSuitJudgementPushRequest.FileModel> list6 = new ArrayList<AlibabaLegalSuitJudgementPushRequest.FileModel>();
AlibabaLegalSuitJudgementPushRequest.FileModel obj7 = new AlibabaLegalSuitJudgementPushRequest.FileModel();
list6.add(obj7);
obj7.setName("cs");
obj7.setKey("cd");
obj1.setJudgeFiles(list6);
List<AlibabaLegalSuitJudgementPushRequest.FileModel> list9 = new ArrayList<AlibabaLegalSuitJudgementPushRequest.FileModel>();
AlibabaLegalSuitJudgementPushRequest.FileModel obj10 = new AlibabaLegalSuitJudgementPushRequest.FileModel();
list9.add(obj10);
obj10.setName("cs");
obj10.setKey("cd");
obj1.setSettlementAgreeFiles(list9);
List<AlibabaLegalSuitJudgementPushRequest.FileModel> list12 = new ArrayList<AlibabaLegalSuitJudgementPushRequest.FileModel>();
AlibabaLegalSuitJudgementPushRequest.FileModel obj13 = new AlibabaLegalSuitJudgementPushRequest.FileModel();
list12.add(obj13);
obj13.setName("cs");
obj13.setKey("scsd");
obj1.setWrittenVerdictFiles(list12);
List<AlibabaLegalSuitJudgementPushRequest.FileModel> list15 = new ArrayList<AlibabaLegalSuitJudgementPushRequest.FileModel>();
AlibabaLegalSuitJudgementPushRequest.FileModel obj16 = new AlibabaLegalSuitJudgementPushRequest.FileModel();
list15.add(obj16);
obj16.setName("cs");
obj16.setKey("cd");
obj1.setMediationCertificateFiles(list15);
List<AlibabaLegalSuitJudgementPushRequest.FileModel> list18 = new ArrayList<AlibabaLegalSuitJudgementPushRequest.FileModel>();
AlibabaLegalSuitJudgementPushRequest.FileModel obj19 = new AlibabaLegalSuitJudgementPushRequest.FileModel();
list18.add(obj19);
obj19.setName("csd");
obj19.setKey("csd");
obj1.setFeedbackAttachmentList(list18);
List<AlibabaLegalSuitJudgementPushRequest.FileModel> list21 = new ArrayList<AlibabaLegalSuitJudgementPushRequest.FileModel>();
AlibabaLegalSuitJudgementPushRequest.FileModel obj22 = new AlibabaLegalSuitJudgementPushRequest.FileModel();
list21.add(obj22);
obj22.setName("dds");
obj22.setKey("cc");
obj1.setOtherFiles(list21);
obj1.setEntrustId(22L);
obj1.setResultFrom("平台tag");
obj1.setOperationType("ADD");
req.setRefereeRegistrationModel(obj1);
AlibabaLegalSuitJudgementPushResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaLegalSuitJudgementPushRequest req = new AlibabaLegalSuitJudgementPushRequest();
AlibabaLegalSuitJudgementPushRequest.RefereeRegistrationModelDomain obj1 = new AlibabaLegalSuitJudgementPushRequest.RefereeRegistrationModelDomain();
obj1.DefendantReceive = "23";
obj1.AmountOurReceive = "23";
obj1.AmountOurGive = "23";
obj1.Amount = "23";
obj1.Processor = "sz";
obj1.IsAssumeResponsibility = "y";
obj1.IsCourtOpened = "y";
obj1.MainPoint = "ss";
obj1.TypicalCause = "cds";
obj1.OtherBusinessLabel = "ss";
obj1.BusinessLabelKeys = "ss";
obj1.JudgementResultSecond = "ss";
obj1.JudgementResult = "败诉";
obj1.ReceivedTime = DateTime.Parse(2019-04-18 19:04:30");
obj1.CallingTime = DateTime.Parse(2019-04-18 19:04:30");
obj1.RegistrationId = 34L;
obj1.SuitId = 23L;
obj1.DropDate = "2019-04-18 19:04:30";
obj1.FeedbackContent = "ss";
obj1.FeedbackId = 3L;
obj1.UpdateTime = DateTime.Parse(2019-04-18 19:04:30");
obj1.CreateTime = DateTime.Parse(2019-04-18 19:04:30");
obj1.Updater = "sz";
obj1.Founder = "sz";
List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain> list3 = new List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain>();
AlibabaLegalSuitJudgementPushRequest.FileModelDomain obj4 = new AlibabaLegalSuitJudgementPushRequest.FileModelDomain();
list3.Add(obj4);
obj4.Name = "cs";
obj4.Key = "sd";
obj1.DroppedFiles= list3;
List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain> list6 = new List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain>();
AlibabaLegalSuitJudgementPushRequest.FileModelDomain obj7 = new AlibabaLegalSuitJudgementPushRequest.FileModelDomain();
list6.Add(obj7);
obj7.Name = "cs";
obj7.Key = "cd";
obj1.JudgeFiles= list6;
List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain> list9 = new List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain>();
AlibabaLegalSuitJudgementPushRequest.FileModelDomain obj10 = new AlibabaLegalSuitJudgementPushRequest.FileModelDomain();
list9.Add(obj10);
obj10.Name = "cs";
obj10.Key = "cd";
obj1.SettlementAgreeFiles= list9;
List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain> list12 = new List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain>();
AlibabaLegalSuitJudgementPushRequest.FileModelDomain obj13 = new AlibabaLegalSuitJudgementPushRequest.FileModelDomain();
list12.Add(obj13);
obj13.Name = "cs";
obj13.Key = "scsd";
obj1.WrittenVerdictFiles= list12;
List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain> list15 = new List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain>();
AlibabaLegalSuitJudgementPushRequest.FileModelDomain obj16 = new AlibabaLegalSuitJudgementPushRequest.FileModelDomain();
list15.Add(obj16);
obj16.Name = "cs";
obj16.Key = "cd";
obj1.MediationCertificateFiles= list15;
List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain> list18 = new List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain>();
AlibabaLegalSuitJudgementPushRequest.FileModelDomain obj19 = new AlibabaLegalSuitJudgementPushRequest.FileModelDomain();
list18.Add(obj19);
obj19.Name = "csd";
obj19.Key = "csd";
obj1.FeedbackAttachmentList= list18;
List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain> list21 = new List<AlibabaLegalSuitJudgementPushRequest.FileModelDomain>();
AlibabaLegalSuitJudgementPushRequest.FileModelDomain obj22 = new AlibabaLegalSuitJudgementPushRequest.FileModelDomain();
list21.Add(obj22);
obj22.Name = "dds";
obj22.Key = "cc";
obj1.OtherFiles= list21;
obj1.EntrustId = 22L;
obj1.ResultFrom = "平台tag";
obj1.OperationType = "ADD";
req.RefereeRegistrationModel_ = obj1;
AlibabaLegalSuitJudgementPushResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaLegalSuitJudgementPushRequest;
$referee_registration_model = new RefereeRegistrationModel;
$referee_registration_model->defendant_receive="23";
$referee_registration_model->amount_our_receive="23";
$referee_registration_model->amount_our_give="23";
$referee_registration_model->amount="23";
$referee_registration_model->processor="sz";
$referee_registration_model->is_assume_responsibility="y";
$referee_registration_model->is_court_opened="y";
$referee_registration_model->main_point="ss";
$referee_registration_model->typical_cause="cds";
$referee_registration_model->other_business_label="ss";
$referee_registration_model->business_label_keys="ss";
$referee_registration_model->judgement_result_second="ss";
$referee_registration_model->judgement_result="败诉";
$referee_registration_model->received_time="2019-04-18 19:04:30";
$referee_registration_model->calling_time="2019-04-18 19:04:30";
$referee_registration_model->registration_id="34";
$referee_registration_model->suit_id="23";
$referee_registration_model->drop_date="2019-04-18 19:04:30";
$referee_registration_model->feedback_content="ss";
$referee_registration_model->feedback_id="3";
$referee_registration_model->update_time="2019-04-18 19:04:30";
$referee_registration_model->create_time="2019-04-18 19:04:30";
$referee_registration_model->updater="sz";
$referee_registration_model->founder="sz";
$dropped_files = new FileModel;
$dropped_files->name="cs";
$dropped_files->key="sd";
$referee_registration_model->dropped_files = $dropped_files;
$judge_files = new FileModel;
$judge_files->name="cs";
$judge_files->key="cd";
$referee_registration_model->judge_files = $judge_files;
$settlement_agree_files = new FileModel;
$settlement_agree_files->name="cs";
$settlement_agree_files->key="cd";
$referee_registration_model->settlement_agree_files = $settlement_agree_files;
$written_verdict_files = new FileModel;
$written_verdict_files->name="cs";
$written_verdict_files->key="scsd";
$referee_registration_model->written_verdict_files = $written_verdict_files;
$mediation_certificate_files = new FileModel;
$mediation_certificate_files->name="cs";
$mediation_certificate_files->key="cd";
$referee_registration_model->mediation_certificate_files = $mediation_certificate_files;
$feedback_attachment_list = new FileModel;
$feedback_attachment_list->name="csd";
$feedback_attachment_list->key="csd";
$referee_registration_model->feedback_attachment_list = $feedback_attachment_list;
$other_files = new FileModel;
$other_files->name="dds";
$other_files->key="cc";
$referee_registration_model->other_files = $other_files;
$referee_registration_model->entrust_id="22";
$referee_registration_model->result_from="平台tag";
$referee_registration_model->operation_type="ADD";
$req->setRefereeRegistrationModel(json_encode($referee_registration_model));
$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.legal.suit.judgement.push' \
-d 'partner_id=apidoc' \
-d 'sign=4BD3542297863022BA59717759B40DA1' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-06-26+20%3A01%3A47' \
-d 'v=2.0' \
-d 'referee_registration_model=null'

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

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

req.referee_registration_model=""
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.legal.suit.judgement.push");
add_param(pRequest,"referee_registration_model","数据结构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('alibaba.legal.suit.judgement.push', {
	'referee_registration_model':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_legal_suit_judgement_push_response>
    <result>
        <content>34</content>
        <error_msg>错误信息</error_msg>
        <error_code>错误码</error_code>
        <success>true</success>
    </result>
</alibaba_legal_suit_judgement_push_response>

{
    "alibaba_legal_suit_judgement_push_response":{
        "result":{
            "content":34,
            "error_msg":"错误信息",
            "error_code":"错误码",
            "success":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.legal.suit.judgement.push (推送裁判登记信息给集团法务系统)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ