法院黑名單個(gè)人執(zhí)行文書信息接口

版權(quán)所有

?華付數(shù)據(jù)—中國金融大數(shù)據(jù)領(lǐng)先平臺！QR-29-05法院黑名單個(gè)人執(zhí)行文書信息 PAGEiii版權(quán)所有

?華付數(shù)據(jù)—中國金融大數(shù)據(jù)領(lǐng)先平臺！法院黑名單個(gè)人執(zhí)行文書信息華付數(shù)據(jù)鑒權(quán)數(shù)據(jù)中心

文檔信息文檔版本號V1.0起草人張波起草日期2016/08/26審核人林曉彬?qū)徍巳掌?016/08/28批準(zhǔn)人湯紅審核日期2016/09/06修訂記錄版本日期作者說明V1.02016/08/25張波初稿V1.02016/08/28林曉彬定稿本文檔中的所有內(nèi)容為鑒權(quán)數(shù)據(jù)中心的機(jī)密和專屬所有。未經(jīng)鑒權(quán)數(shù)據(jù)中心的明確書面許可，任何組織或個(gè)人不得以任何目的、任何形式及任何手段復(fù)制或傳播本文檔部分或全部內(nèi)容。

目錄TOC\o"1-1"\h\z\t"標(biāo)題2,2,標(biāo)題3,3"1 概述 42 接口介紹 42.1通訊協(xié)議 42.2安全協(xié)議 42.2.1加解密 42.2.2簽名方式 42.3接入規(guī)則 52.3.1IP綁定 52.3.2使用范圍 52.3.3字符編碼 52.4法院黑名單個(gè)人執(zhí)行文書信息請求接口地址 52.5請求接口 52.6接口返回 62.7錯誤代碼定義 9PAGEQR-29-05法院黑名單個(gè)人執(zhí)行文書信息 第9頁共9頁概述法院黑名單個(gè)人執(zhí)行文書信息規(guī)范文檔主要用于制定標(biāo)準(zhǔn)的接口接入準(zhǔn)則及流程，指導(dǎo)用戶開發(fā)人員及測試等相關(guān)技術(shù)人員快速了解鑒權(quán)數(shù)據(jù)中心提供的數(shù)據(jù)接口方式和相關(guān)規(guī)范，并且方便快捷的實(shí)現(xiàn)接口對接。接口介紹通訊協(xié)議鑒權(quán)數(shù)據(jù)中心對外數(shù)據(jù)接口主要以http協(xié)議發(fā)布安全協(xié)議加解密鑒權(quán)數(shù)據(jù)中心接口根據(jù)主流加解密方法定義了標(biāo)準(zhǔn)統(tǒng)一的加解密方式，DESede進(jìn)行加解密，即：鑒權(quán)數(shù)據(jù)中心針對用戶申請的接口分配唯一的接入秘鑰，用戶通過所分配的秘鑰及任意隨機(jī)的8位偏移量進(jìn)行數(shù)據(jù)加密。Stringdata=allJson.toString();System.out.println("請求報(bào)文："+data);//平臺分配的唯一的接入秘鑰StringprivateKey="l4mdofLTvHkyONpdlyXBiaTv";Stringvector="12345678";//隨機(jī)8位偏移量StringencrData=Cipher3DES.encrypt(data,privateKey,vector);System.out.println("加密報(bào)文："+encrData);簽名方式接入方對自己加密完成的請求報(bào)文字符串進(jìn)行簽名（注意：是加密后再簽名），鑒權(quán)數(shù)據(jù)中心提供統(tǒng)一的RSA簽名方式，即：用戶可在平臺在線生成或者自行生成簽名密鑰對，同時(shí)將簽名公鑰上傳至平臺，私鑰留下自己注意保密，通過生成的簽名私鑰進(jìn)行簽名，產(chǎn)生簽名值。通過平臺簽名公鑰和平臺返回簽名值進(jìn)行驗(yàn)簽。//根據(jù)用戶自己的簽名私鑰對加密報(bào)文進(jìn)行簽名Stringsignature=RsaSignCoder.sign(encrData,signPrivateKey);System.out.println("簽名值："+signature);//根據(jù)平臺簽名公鑰對平臺返回的加密報(bào)文進(jìn)行驗(yàn)證簽名booleanisTrue=RsaSignCoder.verify(datas,signPublicKey,sign);注：具體請參考示例代碼接入規(guī)則IP綁定用戶在進(jìn)行接入的時(shí)候需要向鑒權(quán)數(shù)據(jù)中心提供接入服務(wù)器的一個(gè)或多個(gè)公網(wǎng)IP。使用范圍鑒權(quán)數(shù)據(jù)中心對于敏感數(shù)據(jù)接口，每次請求需要說明查詢原因作為中心留存，用戶必須與鑒權(quán)數(shù)據(jù)中心簽署數(shù)據(jù)使用相關(guān)責(zé)任協(xié)議。鑒權(quán)數(shù)據(jù)中心會為每一個(gè)接入用戶分配唯一的用戶編號，用戶可使用同一個(gè)用戶編號申請多個(gè)數(shù)據(jù)接口，但每個(gè)接口分別生成不同的密鑰進(jìn)行加解密及簽名。注：鑒權(quán)數(shù)據(jù)中心針對一個(gè)用戶多接口只提供多個(gè)加密秘鑰，一個(gè)簽名公鑰，本地簽名密鑰對用戶自己生成。字符編碼鑒權(quán)數(shù)據(jù)中心接口接收和返回統(tǒng)一以UTF-8字符集編碼格式進(jìn)行接收返回法院黑名單個(gè)人執(zhí)行文書信息請求接口地址/superapi/super/courtblack/queryPersonalDocument請求接口接受參數(shù)： 參數(shù)名稱參數(shù)說明condition請求條件的加密報(bào)文userCode平臺分配的用戶編號signature加密請求報(bào)文的簽名值vector加密偏移量，用戶隨機(jī)生成8位隨機(jī)數(shù)字或字母條件字段說明：字段名稱注釋說明請求說明qryBatchNo查詢批次號唯一，不超過20位userCode商戶編號平臺分配的商戶編號sysCode應(yīng)用編號平臺創(chuàng)建應(yīng)用分配的唯一編號qryReason查詢原因簡單說明調(diào)用原由，可為空qryDate查詢?nèi)掌诟袷剑簓yyyMMdd，可為空qryTime查詢時(shí)間格式：hhmmss，可為空realName姓名不超過20位idCard身份證號碼正確的身份證號碼請求條件報(bào)文格式：{

"header":{

"qryBatchNo":

"20160525151642123",

"userCode":

"TEST10001","sysCode":

"TESTAPP10001",

"qryReason":

"信貸",

"qryDate":

"20160526",

"qryTime":

"113106"

},

"condition":

{

"realName":

"鄭華林",

"idCard":

}接口返回返回參數(shù)：參數(shù)名稱參數(shù)說明contents返回?cái)?shù)據(jù)的加密報(bào)文signature加密請求報(bào)文的簽名值正確返回字段說明：字段名稱字段說明header報(bào)文頭name返回?cái)?shù)據(jù)的名稱recordNum返回?cái)?shù)據(jù)的數(shù)量realName真實(shí)姓名idCard身份證號碼documentId執(zhí)行公告IDdocTitle標(biāo)題docContent內(nèi)容executionStatus執(zhí)行狀態(tài)personName被執(zhí)行人姓名courtName法院status案件狀態(tài)identityNumber身份證executionMoney執(zhí)行標(biāo)的resCode結(jié)果代碼resDesc結(jié)果描述正確返回報(bào)文格式：

"data":[

{

"name":

"個(gè)人執(zhí)行文書記錄",

"recordNum":

1,

"record":

[

{

"realName":

"鄭華林",

"idCard":

,

"resCode":

"00",

"resDesc":

"查詢成功"

}

]

},

{

"name":

"個(gè)人執(zhí)行文書信息",

"recordNum":

1,

"record":

[

{

"documentId":

"97523672@AVb-iZgIpBwvZn0S2iuT",

"docTitle":

"鄭華林",

"docContent":

"...1****0716

鄭華林...",

"executionStatus":

"0",

"personName":

"鄭華林",

"courtName":

"紹興市越城區(qū)人民法院",

"status":

"1",

"identityNumber":

"33062219671****0716",

"executionMoney":

"326610.38"

}

]

}

]}錯誤返回字段說明：字段名稱字段說明code錯誤代碼codeDesc錯誤代碼描述錯誤返回報(bào)文格式：{

"msg":{

"codeDesc":

"姓名校驗(yàn)不通過",

"code":

"01"

}}錯誤代碼定義錯誤代碼代碼描述說明00查詢成功98查無記錄01姓名校