淘宝开放平台

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
param_picc_claim_pay_result_request_d_t_o	PiccClaimPayResultRequestDTO	必须			请求报文
picc_claim_pay_result_request_body_d_t_o PiccClaimPayResultRequestBodyDTO 必须请求报文体 └ claim_status String 必须 "00" 理赔状态 └ fail_reason String 可选 "xxx" 失败/拒赔原因 └ old_regist_no String 必须 "xxx" 非车报案号 └ person_for_loss_flag String 必须 "xxx" 领款人id └ policy_no String 必须 "xxx" 小保单号 └ regist_no String 必须 "xxx" 报案号 └ req_case_status String 必须 "Y" 支付状态 └ sum_loss String 可选 "1000.00" 核赔金额 └ sum_real_pay String 可选 "1000.00" 理赔金额 picc_claim_pay_result_request_head_d_t_o PiccClaimPayResultRequestHeadDTO 必须请求报文头 └ flowin_time String 必须 "xxx" 请求服务时间 └ password String 必须 "xxx" 密码 └ request_type String 必须 "xxx" 请求类型 └ sender String 必须 "xxx" 发送者代码 └ server_version String 必须 "xxx" 服务器版本 └ user String 必须 "xxx" 用户 └ uuid String 必须 "xxx" 请求唯一标识

名称	类型	示例值	描述
result	PiccClaimPayResultResponseDTO		返回报文
picc_claim_pay_result_response_body_d_t_o PiccClaimPayResultResponseBodyDTO 返回报文体 └ error_message String "xxx" 错误信息 picc_claim_pay_result_response_head_d_t_o PiccClaimPayResultResponseHeadDTO 返回报文头 └ password String "xxx" 密码 └ request_type String "xxx" 请求类型 └ sender String "xxx" 发送者 └ server_version String "xxx" 服务器版本 └ user String "xxx" 用户 └ uuid String "xxx" 请求唯一标识

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AlibabaJymInsurancePiccClaimCallbackRequest req = new AlibabaJymInsurancePiccClaimCallbackRequest();
AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestDTO obj1 = new AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestDTO();
AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestBodyDTO obj2 = new AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestBodyDTO();
obj2.setClaimStatus("\"00\"");
obj2.setFailReason("\"xxx\"");
obj2.setOldRegistNo("\"xxx\"");
obj2.setPersonForLossFlag("\"xxx\"");
obj2.setPolicyNo("\"xxx\"");
obj2.setRegistNo("\"xxx\"");
obj2.setReqCaseStatus("\"Y\"");
obj2.setSumLoss("\"1000.00\"");
obj2.setSumRealPay("\"1000.00\"");
obj1.setPiccClaimPayResultRequestBodyDTO(obj2);
AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestHeadDTO obj3 = new AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestHeadDTO();
obj3.setFlowinTime("\"xxx\"");
obj3.setPassword("\"xxx\"");
obj3.setRequestType("\"xxx\"");
obj3.setSender("\"xxx\"");
obj3.setServerVersion("\"xxx\"");
obj3.setUser("\"xxx\"");
obj3.setUuid("\"xxx\"");
obj1.setPiccClaimPayResultRequestHeadDTO(obj3);
req.setParamPiccClaimPayResultRequestDTO(obj1);
AlibabaJymInsurancePiccClaimCallbackResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

ITopClient client = new DefaultTopClient(url, appkey, secret);
AlibabaJymInsurancePiccClaimCallbackRequest req = new AlibabaJymInsurancePiccClaimCallbackRequest();
AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestDTODomain obj1 = new AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestDTODomain();
AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestBodyDTODomain obj2 = new AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestBodyDTODomain();
obj2.ClaimStatus = "\"00\"";
obj2.FailReason = "\"xxx\"";
obj2.OldRegistNo = "\"xxx\"";
obj2.PersonForLossFlag = "\"xxx\"";
obj2.PolicyNo = "\"xxx\"";
obj2.RegistNo = "\"xxx\"";
obj2.ReqCaseStatus = "\"Y\"";
obj2.SumLoss = "\"1000.00\"";
obj2.SumRealPay = "\"1000.00\"";
obj1.PiccClaimPayResultRequestBodyDTO= obj2;
AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestHeadDTODomain obj3 = new AlibabaJymInsurancePiccClaimCallbackRequest.PiccClaimPayResultRequestHeadDTODomain();
obj3.FlowinTime = "\"xxx\"";
obj3.Password = "\"xxx\"";
obj3.RequestType = "\"xxx\"";
obj3.Sender = "\"xxx\"";
obj3.ServerVersion = "\"xxx\"";
obj3.User = "\"xxx\"";
obj3.Uuid = "\"xxx\"";
obj1.PiccClaimPayResultRequestHeadDTO= obj3;
req.ParamPiccClaimPayResultRequestDTO_ = obj1;
AlibabaJymInsurancePiccClaimCallbackResponse rsp = client.Execute(req);
Console.WriteLine(rsp.Body);

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AlibabaJymInsurancePiccClaimCallbackRequest;
$param_picc_claim_pay_result_request_d_t_o = new PiccClaimPayResultRequestDTO;
$picc_claim_pay_result_request_body_d_t_o = new PiccClaimPayResultRequestBodyDTO;
$picc_claim_pay_result_request_body_d_t_o->claim_status="\"00\"";
$picc_claim_pay_result_request_body_d_t_o->fail_reason="\"xxx\"";
$picc_claim_pay_result_request_body_d_t_o->old_regist_no="\"xxx\"";
$picc_claim_pay_result_request_body_d_t_o->person_for_loss_flag="\"xxx\"";
$picc_claim_pay_result_request_body_d_t_o->policy_no="\"xxx\"";
$picc_claim_pay_result_request_body_d_t_o->regist_no="\"xxx\"";
$picc_claim_pay_result_request_body_d_t_o->req_case_status="\"Y\"";
$picc_claim_pay_result_request_body_d_t_o->sum_loss="\"1000.00\"";
$picc_claim_pay_result_request_body_d_t_o->sum_real_pay="\"1000.00\"";
$param_picc_claim_pay_result_request_d_t_o->picc_claim_pay_result_request_body_d_t_o = $picc_claim_pay_result_request_body_d_t_o;
$picc_claim_pay_result_request_head_d_t_o = new PiccClaimPayResultRequestHeadDTO;
$picc_claim_pay_result_request_head_d_t_o->flowin_time="\"xxx\"";
$picc_claim_pay_result_request_head_d_t_o->password="\"xxx\"";
$picc_claim_pay_result_request_head_d_t_o->request_type="\"xxx\"";
$picc_claim_pay_result_request_head_d_t_o->sender="\"xxx\"";
$picc_claim_pay_result_request_head_d_t_o->server_version="\"xxx\"";
$picc_claim_pay_result_request_head_d_t_o->user="\"xxx\"";
$picc_claim_pay_result_request_head_d_t_o->uuid="\"xxx\"";
$param_picc_claim_pay_result_request_d_t_o->picc_claim_pay_result_request_head_d_t_o = $picc_claim_pay_result_request_head_d_t_o;
$req->setParamPiccClaimPayResultRequestDTO(json_encode($param_picc_claim_pay_result_request_d_t_o));
$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.jym.insurance.picc.claim.callback' \
-d 'partner_id=apidoc' \
-d 'sign=B30EC918A3158472D9244E7FBBD997A3' \
-d 'sign_method=hmac' \
-d 'timestamp=2025-03-05+10%3A15%3A04' \
-d 'v=2.0' \
-d 'param_picc_claim_pay_result_request_d_t_o=null'

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

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

req.param_picc_claim_pay_result_request_d_t_o="数据结构示例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,"alibaba.jym.insurance.picc.claim.callback");
add_param(pRequest,"param_picc_claim_pay_result_request_d_t_o","数据结构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.jym.insurance.picc.claim.callback', {
	'param_picc_claim_pay_result_request_d_t_o':'数据结构JSON示例'
}, function(error, response) {
	if (!error) console.log(response);
	else console.log(error);
})

XML示例
JSON示例

<alibaba_jym_insurance_picc_claim_callback_response>
    <result>
        <picc_claim_pay_result_response_body_d_t_o>
            <error_message>&quot;xxx&quot;</error_message>
        </picc_claim_pay_result_response_body_d_t_o>
        <picc_claim_pay_result_response_head_d_t_o>
            <password>&quot;xxx&quot;</password>
            <request_type>&quot;xxx&quot;</request_type>
            <sender>&quot;xxx&quot;</sender>
            <server_version>&quot;xxx&quot;</server_version>
            <user>&quot;xxx&quot;</user>
            <uuid>&quot;xxx&quot;</uuid>
        </picc_claim_pay_result_response_head_d_t_o>
    </result>
</alibaba_jym_insurance_picc_claim_callback_response>

{
    "alibaba_jym_insurance_picc_claim_callback_response":{
        "result":{
            "picc_claim_pay_result_response_body_d_t_o":{
                "error_message":"\"xxx\""
            },
            "picc_claim_pay_result_response_head_d_t_o":{
                "password":"\"xxx\"",
                "request_type":"\"xxx\"",
                "sender":"\"xxx\"",
                "server_version":"\"xxx\"",
                "user":"\"xxx\"",
                "uuid":"\"xxx\""
            }
        }
    }
}

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.jym.insurance.picc.claim.callback (人保理赔结果回调)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ