淘宝开放平台 - 文档中心

请求地址：

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

名称	类型	是否必须	示例值	更多限制	描述
interview_a_p_i_request	InterviewApiRequest	可选			interviewAPIRequest
└ loan_order_no String 必须 24010900100YSKSSG 贷款申请单号 └ interview_result_code String 必须 PASS 面签结果枚举：PASS ：通过；NOT_PASS：不通过 └ interview_time String 可选 2022-10-08 09:55:00 面签完成时间格式：yyyy-MM-dd HH:mm:ss └ loan_bank_name String 可选 XX银行杭州分行贷款行名称 └ bank_loan_contract_number String 可选 202301012123A 银行的贷款合同编号 └ loan_amount Number 可选 2000000 贷款金额，单位元 └ loan_months Number 可选 48 贷款期限（月） └ lending_rates String 可选 3.34 贷款利率 └ floating Boolean 可选 true 贷款利率是否浮动 └ primary_borrower_name String 可选张小甜主借款人姓名 └ primary_borrower_cert_type String 可选 IDENTITY_CARD 主借款人证件类型枚举： unknown:其他证件;BUSINESS_LICENSE:企业营业执照;IDENTITY_CARD:身份证;BACK_HOMETOWN_CARD,台胞证;HK_CARD:港澳证件;PASSPORT:护照 ;OFFICER_CARD:军官证;BUSINESS_LICENSE:组织机构代码证件;UNIFIED_SOCIAL_CREDIT_CODE:统一社会信用代码;OTHERS:其他证件;OTHERS-CHINA-PASSPORTS:中国护照;OTHERS-HOUSEHOLD-REG-BOOK:户口簿;OTHERS-ENTERPRISE-LEGALPERSON-REG-CER:事业法人登记证件 └ primary_borrower_cert_code String 可选 3303887782778978 主借款人身份ID └ primary_borrower_contact_number String 可选 18628776567 主借款人手机号 └ primary_borrower_bank_account String 可选 3789102391739181231 主贷款人Ⅰ Ⅱ类户账号 └ co_borrower_name String 可选纪晓云共同借款人姓名 └ co_borrower_cert_type String 可选 IDENTITY_CARD 共同借款人证件类型枚举： unknown:其他证件;BUSINESS_LICENSE:企业营业执照;IDENTITY_CARD:身份证;BACK_HOMETOWN_CARD,台胞证;HK_CARD:港澳证件;PASSPORT:护照 ;OFFICER_CARD:军官证;BUSINESS_LICENSE:组织机构代码证件;UNIFIED_SOCIAL_CREDIT_CODE:统一社会信用代码;OTHERS:其他证件;OTHERS-CHINA-PASSPORTS:中国护照;OTHERS-HOUSEHOLD-REG-BOOK:户口簿;OTHERS-ENTERPRISE-LEGALPERSON-REG-CER:事业法人登记证件 └ co_borrower_cert_code String 可选 3789102391739181231 共同借款人身份ID └ co_borrower_contact_number String 可选 18628776567 共同借款人手机号 └ memo String 可选面签通过尽快支付首付款说明 └ deadline String 可选 2022-10-08 09:55:00 法院收款截止时间格式：yyyy-MM-dd HH:mm:ss └ loan_intention_url_list String [] 可选 123456 oss文件地址列表 └ loan_bank_social_credit_code String 可选 12345 贷款银行统一社会信用代码 └ service_provider_name String 可选测试服务商服务商名称 └ service_provider_id Number 可选 123456 服务商id └ business_person_name String 可选测试业务人员名称 └ business_person_phone Number 可选 130923152361 业务人员电话 └ id_card_url_list String [] 可选 ["aaa","bbb"] 身份证证件oss地址

名称	类型	示例值	描述
call_success	Boolean	true	是否成功
fail_code	String	XXX_ERROR	错误编码
fail_message	String	错误信息内容	错误信息

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

TaobaoClient client = new DefaultTaobaoClient(url, appkey, secret);
AuctionLoanOnlineInterviewcallbackRequest req = new AuctionLoanOnlineInterviewcallbackRequest();
AuctionLoanOnlineInterviewcallbackRequest.InterviewApiRequest obj1 = new AuctionLoanOnlineInterviewcallbackRequest.InterviewApiRequest();
obj1.setLoanOrderNo("24010900100YSKSSG");
obj1.setInterviewResultCode("PASS");
obj1.setInterviewTime("2022-10-08 09:55:00");
obj1.setLoanBankName("XX银行杭州分行");
obj1.setBankLoanContractNumber("202301012123A");
obj1.setLoanAmount(2000000L);
obj1.setLoanMonths(48L);
obj1.setLendingRates("3.34");
obj1.setFloating(true);
obj1.setPrimaryBorrowerName("张小甜");
obj1.setPrimaryBorrowerCertType("IDENTITY_CARD");
obj1.setPrimaryBorrowerCertCode("3303887782778978");
obj1.setPrimaryBorrowerContactNumber("18628776567");
obj1.setPrimaryBorrowerBankAccount("3789102391739181231");
obj1.setCoBorrowerName("纪晓云");
obj1.setCoBorrowerCertType("IDENTITY_CARD");
obj1.setCoBorrowerCertCode("3789102391739181231");
obj1.setCoBorrowerContactNumber("18628776567");
obj1.setMemo("面签通过尽快支付首付款");
obj1.setDeadline("2022-10-08 09:55:00");
obj1.setLoanIntentionUrlList("123456");
obj1.setLoanBankSocialCreditCode("12345");
obj1.setServiceProviderName("测试服务商");
obj1.setServiceProviderId(123456L);
obj1.setBusinessPersonName("测试");
obj1.setBusinessPersonPhone(130923152361L);
obj1.setIdCardUrlList(""aaa","bbb"");
req.setInterviewAPIRequest(obj1);
AuctionLoanOnlineInterviewcallbackResponse rsp = client.execute(req);
System.out.println(rsp.getBody());

$c = new TopClient;
$c->appkey = $appkey;
$c->secretKey = $secret;
$req = new AuctionLoanOnlineInterviewcallbackRequest;
$interview_a_p_i_request = new InterviewApiRequest;
$interview_a_p_i_request->loan_order_no="24010900100YSKSSG";
$interview_a_p_i_request->interview_result_code="PASS";
$interview_a_p_i_request->interview_time="2022-10-08 09:55:00";
$interview_a_p_i_request->loan_bank_name="XX银行杭州分行";
$interview_a_p_i_request->bank_loan_contract_number="202301012123A";
$interview_a_p_i_request->loan_amount="2000000";
$interview_a_p_i_request->loan_months="48";
$interview_a_p_i_request->lending_rates="3.34";
$interview_a_p_i_request->floating="true";
$interview_a_p_i_request->primary_borrower_name="张小甜";
$interview_a_p_i_request->primary_borrower_cert_type="IDENTITY_CARD";
$interview_a_p_i_request->primary_borrower_cert_code="3303887782778978";
$interview_a_p_i_request->primary_borrower_contact_number="18628776567";
$interview_a_p_i_request->primary_borrower_bank_account="3789102391739181231";
$interview_a_p_i_request->co_borrower_name="纪晓云";
$interview_a_p_i_request->co_borrower_cert_type="IDENTITY_CARD";
$interview_a_p_i_request->co_borrower_cert_code="3789102391739181231";
$interview_a_p_i_request->co_borrower_contact_number="18628776567";
$interview_a_p_i_request->memo="面签通过尽快支付首付款";
$interview_a_p_i_request->deadline="2022-10-08 09:55:00";
$interview_a_p_i_request->loan_intention_url_list="123456";
$interview_a_p_i_request->loan_bank_social_credit_code="12345";
$interview_a_p_i_request->service_provider_name="测试服务商";
$interview_a_p_i_request->service_provider_id="123456";
$interview_a_p_i_request->business_person_name="测试";
$interview_a_p_i_request->business_person_phone="130923152361";
$interview_a_p_i_request->id_card_url_list="[\"aaa\",\"bbb\"]";
$req->setInterviewAPIRequest(json_encode($interview_a_p_i_request));
$resp = $c->execute($req);

XML示例
JSON示例

<auction_loan_online_interviewcallback_response>
    <call_success>true</call_success>
    <fail_code>XXX_ERROR</fail_code>
    <fail_message>错误信息内容</fail_message>
</auction_loan_online_interviewcallback_response>

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>

错误码	错误描述	解决方案

API测试工具错误码查询工具 SDK下载

开放平台

拍卖API

taobao.auction.loan.online.interviewcallback (面签回调接口)

公共参数

请求参数

响应参数

请求示例

响应示例

异常示例

错误码解释

API工具

如何获得此API

FAQ