江西省可信身份認證系統

對接規范

2020年10月

修訂歷史記錄

日期版本說明作者

<2020-07><1.0>初始版本〈廖金彪＞

<2020-09><1.1>修改4.1.2章節〈廖金彪＞

<2020-09><1.2>修改3.1.1章節v廖金彪＞

<2020-10><1.3>修改4.2章節內容〈廖金彪＞

<2020-10><1,4>修改第5章節內容〈廖金彪＞

目錄

1.簡介5

1.1.定義、首字母縮寫詞和縮略語5

1.2.安全規范6

1.2.1數據接口權限6

1.2.2敏感信息展示6

1.2.3簽名規則6

1.2.4數據加密7

2.應用接入流程8

2.1.接入流程8

2.2.應用申請9

2.3.應用審核9

2.4.開發及聯調9

2.5.應用上線9

2.6.運營維護9

3.開發指引10

3.1、注冊場景10

3.1.1s個人用戶注冊10

3.1.2、法人用戶注冊10

3.2、登錄10

3.2.1.獲取個人用戶信息10

3.2.2,獲取企業詳細信息10

3.3、用戶認證11

3.3.1.個人認證11

3.3.2.法人認證11

4,接口規范11

4.1s個人服務接口定義11

4.1.1手機號判重接口11

4.1.2短信驗證碼發送接口12

4.1.3手機號短信校驗接口13

4.1.4個人身份證判重接口14

4.1.5手機號+驗證碼注冊接口15

4.1.6個人身份證找回接口16

4.1.7根據令牌獲取個人用戶詳細信息17

4.1.8實名等級變更接口20

4.1.9簡項信息比對接口21

4.1.10人臉比對接口22

4.1.11復合信息比對接口24

4.1.12出入境證件實名核驗接口26

4.2、法人服務接口定義28

4.2.1綁定企業接口（個人升級法人）28

4.2.2修改企業信息接口29

4.2.3獲取法人令牌接口（個人令牌換法人令牌）30

4.2.4查詢企業詳情接口31

4.2.5查詢企業列表接口33

4.2.6法人解綁企業接口34

4.2.7添加授權帳號（個人綁定企業成為管理員或者經辦人）35

4.2.8修改授權帳號37

4.2.9刪除授權帳號38

4.2.10查詢企業用戶39

4.2.11解除授權40

4.2.12企業法人/管理員認證接口41

4.2.13查詢企業詳情（企業空間）42

4.2.14法人實名核驗接口44

5單點登錄48

5.1s單點接入48

5.1.1.接入范圍48

5.1.2、單點流程48

5.1.3.自建系統對接49

5.1.4、接口調用說明52

5.2、接口定義52

521、通過統一登錄頁面獲取票據52

522、通過票據獲取令牌53

523、根據令牌獲取后臺用戶詳細信息55

5.2.4、根據令牌獲取個人用戶詳細信息56

525、根據令牌獲取法人用戶詳細信息59

526、根據令牌獲取法人企業詳細信息61

527、根據令牌獲取第三方接口資源票據63

528、通過刷新令牌獲取令牌64

529、注銷接口66

5210、統一帳號管理頁面66

6性能67

7附錄錯誤味定義書簽。

7.1.對接申請表67

7.2.MD5加解密DEMO67

7.3.AES加解密DEMO68

7.4.公共返回碼68

7.5.實名核驗等級71

L簡介

本文檔定義了江西省可信身份認證系統的接口規范和標準以及對接方案，旨在給第三方

實現接口開發提供參考。

1.1.定義、首字母縮寫詞和縮略語

>單點登錄(SingleSignOn):簡稱為SSO,接入JIS的多個應用系統中，用戶只需

要登錄一次就可以訪問所有相互信任的應用系統。

>票據picket)：票據用于江西省可信身份認證系統單點登錄到第三方應用時，統一

發放給第三方應用為授權憑證信息，用于系統間的授權互信，第三方應用可以通過

校驗該憑證獲得授權令牌(token),票據只能使用一次且具有時效性。

>令牌(token):安全認證信息。令牌用于第三方應用進行票據認證成功后獲取的安

全認證信息，第三方應用可以通過該安全認證信息獲取用戶的基礎信息。令牌可以

多次使用且具有時效性(默認為2小時)，第三方應用需要及時刷新令牌以保證及時

獲取用戶。

>應用標識(appmark):應用的身份唯一標識。應用標識為江西省可信身份認證系統

分配給第三方的應用的唯一標識，第三方應用系統在調用江西省可信身份認證系統

接口時，應用標識作為參數傳入。

>應用密鑰(appword)：應用密鑰為江西省可信身份認證系統分配給第三方的應用的

安全鑰匙，在第三方應用系統調用江西省可信身份認證系統接口服務時，應用標

識、應用密鑰和當前時間戳按照順序拼接進行MD5加密作為參數傳入。

>代理接入資源應用標識(proxyapp):已經單點登錄的業務系統請求江西省可信身份

認證系統的獲取第三方資源票據接口生成票據作為參數傳入，實現刷新令牌或讓目

標系統進行單點登錄的目的。

>SM2：是國家密碼管理局于2010年12月17日發布的橢圓曲線公鑰密碼算法，是

一種非對稱加密算法，公鑰加密數據，由私鑰解密。

>AES:AdvancedEncryptionStandard,高級對稱加密算法；

>MD5:Message-DgestAlgorithm5（信息-摘要算法），安全加密算法。

>BASE64：用于傳輸8Bit字節碼的編碼方式之一，是一種基于64個可打印字符又表

示二進制數據的方法。

1.2.安全規范

1.2.1數據接口權限

接入系統默認沒有權限獲取用戶敏感信息，如需要獲取敏感信息。

敏感信息如下：

公民身份號碼、姓名、手機號、固定電話號碼、郵箱、家庭住址等等。

1.2.2敏感信息展示

在web前端內容中出現用戶個人敏感信息時，應按照規范進行部分隱藏。具體的前端

內容包括但不限于：

■前端Web頁面（含h5頁面）的所有敏感信息。

■Javascript腳本

■URL地址

缺省信息隱藏規則：

證件號碼前臺展示規范：前1位和后1位，其它用*號代替，如"3*****************4”；

手機號：顯示前3和后4位,其它用上代替，如“183****7492”

郵箱：顯示前兩位和符號前一位開始至末尾的所有字符，其余用*代替。如

M18*********（§）M

姓名：姓使用*代替，如"*三"

1.2.3簽名規則

江西省可信身份認證系統為每個應用分配應用標識（appmark）和應用密鑰（appword）,

應用標識為應用身份的唯一標識，應用密鑰為調用江西省可信身份認證系統接口服務時的鑰

匙，在調用時需將兩者拼接并加上時間戳，對時間進行簽名。

簽名算法：MD5（appmark+appword+time）,將應用標識、應用密鑰、發送時間按順

序連接并進行md5加密。

簽名認證的參數：

名稱說明是否必填數據類型長度（字節）

appmark接入應用在可信身份認

是String

證系統注冊成功后的應

用標識，由【管理員】提

供。

time時間戳，當前時間

年月日時分秒

例：2009年10月10日是String

12時12分12秒格式為

12

signMD5(appmark+

appword+timc),將應用

標識、應用密鑰、發送時

間按順序連接并進行

md5加密。注:1、參數

是String

appmsrk、appword由

【管理員】提供；

2、MD5加密方法是32位

的原生加密方法；

3、time是時間戳

1.2.4數據加密

江西省可信身份認證系統對數據在傳輸的過程中進行加密傳輸，加密方式根據傳輸的具

體情況分為兩種：

(1)由第三方系統向江西省可信身份認證系統傳輸數據時，可通過AES加密方式，

對敏感信息進行加密傳輸；

由江西省可信身份認證系統向第三方系統傳輸數據時，可通過SM2加密方式，對敏感

信息進行加密傳輸.

2,應用接入流程

2.1.接入流程

提51

*

獲取《口防需妾的

I___遺傳加密故后和客戶少

接

口

調

用

階

段

2.2.應用申請

申請單位首先需要向江西省信息中心提出申請，填寫《江西省可信身份認證系統接入申

請表》和《江西省可信身份認證系統接入承諾函》（見附錄7.1）,申請成功之后由承建單位

開發對接負責人進行提供以下信息：

2.3.應用審核

申請單位應用申請提供相關應用信息之后，江西省可信身份認證系統應用管理員將對提

供的資料進行審核，審核通過之后為申請應用提供以下相關材料：

appmark,appword,uuid,privatekey,分別為應用標識，應用密鑰（作為簽名和

AES數據加密使用），應用UUID,數據私鑰（SM2解密速用）。

2、相關API和SDK等。

3、調試地址。

2.4.開發及聯調

申請單位按照江西省可信身份認證系統提供的API進行系統改造，申請單位按照自己對

接的功能選擇相對應的接口進行開發，具體參照本文檔接口規范。

2.5.應用上線

申請單位的應用在聯調環境中完成系統功能測試后，可以申請在正式環境上線“此時需

要江西省可信身份認證系統應用管理員在正式環境上架應用并提供信息（例如：正式的接口

地址）給申請單位，申請單位修改對接地址及參數，并完成上線后的基本功能測試。

2.6.運營維護

上線完成后，需要江西省可信身份認證系統的運維商與申請單位的承建開發商共同完成

運營維護的工作。雙方詳細記錄接口調用日志，方便業務異常時問題定位。

3.開發指引

3.1、注冊場景

3.1.1s個人用戶注冊

接口調用說明

通過手機號+短信驗證碼方式注冊個人賬號，注冊成功后返回個人令牌，如果已經存在對應

的賬號了，也返回個人令裨。

第一步：先調4.1.3短信驗證碼發送接口,發送短信驗證碼；

第二步:校驗通過后，再調用4.L5手機號+短信驗證碼注冊接口

3.1.2.法人用戶注冊

3.1.2.1.接口調用說明

第一步：掃臉認證，調用4.1.10人臉比對接口進行實人核驗；

第二步：法人身份核驗，調用427法人檢驗接口，核實當前個人是否是要綁定企業的法人；

第三步：核驗通過后，調用421綁定企業接口（個人升級法人）,如果沒有對應的法人賬號則

生成法人賬號，并添加企業綁定關系，如果有法人賬號了，直接綁定企業。

3.2s登錄

3.2.1.獲取個人用戶信息

3.2.L1.接口調用說明

第一步：先調4.L3短信驗證碼發送接口,發送短信；

第二步：用戶輸入驗證碼后，再調用413手機號短信校驗接口,此接口會返回個人令牌；

第二步：最后再調417根據令牌獲取個人用戶詳細信息,獲取到用戶詳細信息。

3.2.2.獲取企業詳細信息

3.2.2.1.接口調用說明

第一步：個人用戶登錄后，獲取到個人令牌（參考3.121）;

第二步：調用422獲取法人令牌（個人令牌換法人令牌）接口,獲取對應的法人令牌；

第三步：調用424查詢企業列表接口,獲取企業列表信息；

第四步：根據第三步獲取到的企業id,再調用423查詢企業詳情接口，獲取企業詳細信息。

3.3X用戶認證

3.3.1.個人認證

3.3.3.L接口調用說明

江西省可信身份認證系統的用戶實名檢驗等級分5級，等級信息參考7.5實名核驗等級。

笫一步：實名認證，調用4.1.9實名認證接口；實人認證，調用4.L10人臉比對接口；

第二步：認證等級只能提升不能降低，提升實名認證等級調4.L8實名等級變更接口；

3.3.2.法人認證

3.3.2.L接口調用說明

驗證當前用戶是否為本人，并且驗證當前用戶是否為即將綁定的企業的法人。

第一步：調用4.1.10人臉比對接口，驗證當前用戶是否為本人；

第二步：第一步核驗通過后，用戶輸入需要綁定的企業信息；

第三步：調用427法人核驗接口,核驗當前用戶是否為綁定企業的法人。

4,接口規范

4.1s個人服務接口定義

4.1.1手機號判重接口

接口描述

該接口用于手機號認證，填寫完手機號后，判斷手機號是否注冊個人個人用戶。

請求地址

操作操作名稱

方式REST

地址https:〃應用地址/jisapi/

標識jisapiCheckMobileReg

4.11.3請求參數

參數名中文描述類型是否必填

appmark應用標識String必填

params業務參數，json格式。數據固定格式如

下

”{"mobile":“手機號

Suing必填

注意：params需要用AES加密方法進

行加密后傳輸。加密秘鑰為appword

（即應用秘鑰）

41.1.4返回參數

參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

4.1.2短信驗證碼發送接口

4.121接口描述

該接口用于第三方服務發送短信信息

4.122接口地址

操作操作名稱

方式REST

地址http:〃應用地址/jisapi/

標識jisapiSendMobileCode

4.1,2.3請求參數

參數名中文描述類型是否必填

appmark應用標識String必填

params業務參數，json格式。數據固定格式如

下

“{“userType”:“l-個人，2-法人，0-后臺

用戶:mobile":“手機號》

注意：params需要用AES加密方法（加String必填

密方法參照AES加密接口,見3212,

JAVA語言開發的可以參照附錄5.4）進

行加密后傳輸。加密秘鑰為appword

（即應用秘鑰）

返回參數

參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

4.1.3手機號短信校驗接口

接口描述

該接口用于校驗手機號短信是否正確

請求地址

操作操作名稱

方式REST

地址https:〃應用地址/jisapi/

標識jisapiCheckMobileCode

4.1,3.3請求參數

參數名中文描述類型是否必填

appmark應用標識String必填

params業務參數，json格式。數據固定格式如

String必填

下

“{“userType":"l-個人,2-法人,0-后臺

用戶”,

"loginName":"用戶名（法人場景必填）

II

9

“mobile":“手機號二

“mobileCode"：”手機短信驗證

碼‘}"

注意：params需要用AES加密方法進

行加密后傳輸5加密秘鑰為appword

（即應用秘鑰）

返回參數

參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

datadata參數詳情

data參數

參數名中文描述

refreshtoken刷新令牌，有對應賬號的時候返回

token令牌，有對應賬號的時候返回

4.1.4個人身份證判重接口

4.141接口描述

該接口用于判斷身份證是否被搶注，適用于APP手機號注冊場景。

請求地址

操作操作名稱

方式REST

地址https:〃應用地址/jisapi/che

標識checkpapersnumberreg

4.1,4.3請求參數

參數名中文描述類型是否必填

appmark應用標識String必填

params業務參數，json格式。數據固定格式如

下

"{"papersNumber":"證件號碼》

Suing必填

注意：params需要用AES加密方法進

行加密后傳輸。加密秘鑰為appword

（即應用秘鑰）

41.4.4返回參數

4.1.4.5參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

data返回參數，證件沒被占用返回空字符串

data參數

參數名中文描述

flagflag二1標識證件被占用

loginName證件被占用賬號的登錄名

mobile證件被占用賬號的手機號

4.1.5手機號+驗證碼注冊接口

4.151接口描述

該接口配合4.1.2接口一起使用，即根據手機號+短信驗證碼注冊個人賬號，如果賬號存在,

則返回令牌。

4.152接口地址

操作操作名稱

方式REST

地址https://應用地址/jisapi/

標識jisapimobileCodeRegister

41.5.3請求地址

參數名中文描述類型是否必填

appmark應用標識String必填

params業務參數，json格式。數據固定格式如

下

“{“useiType":"l-個人,2-法人（目前只

能注冊個人賬號，不支持法人）：

"mobile":"手機號”，

MmobileCode":"手機短信驗證

String必填

碼”}“

注意：params需要用AES加密方法（力口

密方法參照AES加密接口,見3212,

JAVA語言開發的可以參照附錄5.4）進

行加密后傳輸c加密秘鑰為appword

（即應用秘鑰）

4.154返回參數

4.1.5.5參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

datadata參數詳情

data參數

參數名中文描述

refreshtoken刷新令牌，有對應賬號的時候返回

token令牌，有對應賬號的時候返回

4.1.6個人身份證找回接口

接口描述

該接口用于個人注冊，身份證被其他人搶注測場景，調Jis接口，刪除之前關聯賬號的姓名、

身份證號，并鎖定賬號。

4.1,6.2請求地址

操作操作名稱

方式REST

地址https:〃應用地址/jisapi/

標識jisapiFindPapersNumber

請求參數

參數名中文描述類型是否必填

appmark應用標識String必填

params業務參數，json格式°數據固定格式如

下

"{"papersNumber":"證件號

碼"}“

注意：params需要用AES加密方法（力口String必填

密方法參照AES加密接口,見3212,

JAVA語言開發的可以參照附錄5.4）進

行加密后傳輸“加密秘鑰為appword

（即應用秘鑰）

4.1,6.4返回參數

參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

4.1.7根據令牌獲取個人用戶詳細信息

接口描述

該接口是實現第三方系統使用令牌獲取個人用戶的詳細信息。

4.1,7.2請求地址

操作操作名稱

方式REST

地址https:〃應用地址/sso/

4.1,7.3請求參數

參數名中文描述類型是否必填

appmark應用標識String必填

time時間戳，即當前時間String必填

格式為：年月日時分秒

實例：

2015年05月10日12時12分12秒

格式應寫為202

sign參數內容為：

MD5（appmark+appword+time）

即將應用標識、應用密鑰、當前時間按

順序連接并進行md5加密。

注：1、參數appmark、appwcrd由【管

理員】提供；

2、MD5加密方法是32位的原生加密String必填

方法；（只支持小寫形式，具體可見附

錄）

3、AES加密方式（具體課件附錄）。

4、time是時間戳

servicename業務名稱

String必填

（固定值：findOutsideUserByToken）

params業務參數，json格式。數據固定格式如

下

"（String必填

"token":"令牌”

）"

返回參數

參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

data返回的用戶詳細數據，經過SM2/AES/RSA加密，解密后的數據詳

見data包含的元素說明（解密私鑰由江西省可信身份認證系統管

理員提供；如接口調用失敗，該參數不顯示，解密方式請查看附

錄）

data包含的元素說明

是否必要，默認只返回

參數名中文描述uuid,loginname,其他信息如果需

要，可在接入申請表中申請。

uuid用戶唯一ID默認返回

loginname用戶登錄名默認返回

name用戶姓名（已實名的用戶，姓名需申請

才具有真實性）

code用戶編碼默認返回S

證件類型（默認為1）

1身吩證

3港澳通行證；圭

paperstype而芟ctt]甲C±3由

4臺灣通行證

5外籍人士永久居留證

papersnumber證件號碼需要申請

mobile手機號碼需申請

email電子郵箱需申請

isauthuser是否實名：1-已實名未實名需申請

authlevel實名等級：0：_未認證，1-初級；需申請

2.中級；3-高級；

nation民族，見國標GB3304-91需申請

regtime注冊時間需申請

logintime上一次登錄時間需申請

sex性別：1-男；。-女需申請

post郵編需申請

address地址需申請

nickname昵稱默認返回

residence居住地默認返回

registeredresid戶口所在地默認返回

ence

headportraitp頭像相對地址默認返回

ath

4.1.8實名等級變更接口

4.181接口描述

實名等級只能升級，不能降級。注意：必須保證調該接口前參數是經過認證的，即數據是有

效的。

4.1,8.2請求地址

操作操作名稱

方式REST

地址https:〃應用地址/jisapi/

請求參數

參數名中文描述類型是否必填

appmark應用標識String必填

params業務參數，json格式。數據固定格式如

下

{"token":"BDQBTXNBfl<lyQw5IBURwMH

YlAEMCRgw/BEV9RglwAUMHNwJNdk

4=","name":"張三

String必填

","papersnumber":"","paperstype":"l","l

evel":"l"}

注意：params需要用AES加密方式進

行加密后傳輸。加密秘鑰為appword

（即應用密鑰）

返回參數

參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

data返回數據

data參數

參數名中文描述

sameloginname身份證被搶注的時候返回，被占用的身份證

samemobile身份證被搶注的時候返回，被占用的手機號

4.1.9簡項信息比對接口

4.191接口描述

該接口為簡項信息比對接口，為第三方提供身份證號與姓名進行實名認證提供能力輸出。

參數已通過aes加密,加密模式為:ECB。AES加密后的byte□上封裝的String是HexString,

字符集是utf-8o

注1：暫不支持港澳臺人員實名認證。

注2：接口平均響應時間為300ms。。

4.1,9.2請求地址

操作操作名稱

方式REST

地址ht【ps:〃應用地址/in【erfaces/identify/

請求參數

參數名中文描述類型是否必填

paramsAes加密的json字符串String必填

Json字符串內包含的參數：

參數名中文描述類型是否必填

name用戶姓名String必填

idNum用戶身份證號碼String必填

clientCode調用方標識String必填

sm4key調用方sm4秘鑰String必填

4.194返回參數

4.1.9.5參數名中文描述

result人臉校驗返回碼(0,其他敗)

resultDetail人臉校驗結果

clientCode

similarity識別率

返回實例

(1)成功響應

"result":"0",

"resultDetail":"比對成功”，

"clientCode":"8BD094B4EDFEAED6E001",

"similarity":"100.0"

}

(2)失敗響應

7

"result":"-1",

"resultDetail":“比對失敗

}

4.1.10人臉比對接口

接口描述

人臉比對：傳入用戶姓名、身份證號、現場照片，后臺進行比對核查。參數須通過aes

力口密，加密密鑰為：WKXZilc3ble80hUm。加密模式為:ECB。AES力口密后的byte口上封裝的

String是HexString,字符集是utf-8。接口會在1-2秒內返回結果，人像匹配度達到80%即

可認證成功。

注1：第三方需要用到活體檢測功能時，則必須提供應用包名申請活體檢測SDK包，SDK包

是根據包名進行授權。

注2：港澳人員暫不支持c

注3：如果比對的用戶的信息在江西人口庫中有或緩存庫中有查詢到數據，則不會校驗身份

證有效期；如果在江西人口庫中沒有查詢到數據，就會調用一所的接口，這時候就會校驗身

份證有效期，如果身份證過期則會提示比對失敗。

請求地址

操作操作名稱

方式REST

地址https:〃應用地址/interfaces/identify/

請求參數

參數名中文描述類型是否必填

paramsAes加密的json字符串String必填

Json字符串內包含的參數：

參數名中文描述類型是否必填

name用戶姓名String必填

idNum用戶身份證號碼String必填

idPhoto用戶照片（base64格式）String必填

clientCode調用方標識String必填

sm4key調用方sm4秘鑰String必填

返回參數

參數名中文描述

result人臉校驗返回碼（0,其他敗）

resultDetail人臉校驗結果

clientCode標識調用身份

similarity相似率

返回實例

(1)成功響應

"result":"0",

"resultDetail":"比對成功”，

"clientCode":"8BD094B4EDFEAED6E001",

"similarity":"92.0"

}

(2)失敗響應

"result":"-1",

"resultDetail":"比對失敗

}

4.1.11復合信息比對接口

接口描述

該接口為復合信息比對接口，為第三方提供身份證號、姓名、身份證有效開始日期、身

份證有效結束日期進行四要素核驗。參數已通過aes加密，加密模式為:ECB。AES加密后的

byte□上封裝的String是HexString,字符集是utf-8o

請求地址

操作操作名稱

方式REST

地址https://應用地址/imerfaccs/identify/aesCheckldentify.do

請求參數

參數名中文描述類型是否必填

paramsAes加密的json字符串String必填

Json字符串內包含的參數：

參數名中文描述類型是否必填

nameText姓名String必填

idNum身份證號碼String必填

startTime身份證上有效期開始時間（時間格式為String非必填

yyyyMMdd）

endTime身份證上有效期截止時間（時間格式為String非必填

yyyyMMdd）

clientCode調用方標識String必填

sm4key調用方sm4秘鑰String必填

返回參數

參數名中文描述

result結果碼（比對結果：0-比對成功，-1-比對失敗）

similarity相似度（100或-1）

clientCode客戶編號（標識調用方身份,系統分配）

resultDetail錯誤信息描述

（1）成功響應

(

"result":"0",

"resultDetail":"比時成功'，

"clientCode":"8BD094B4EDFEAED6E001",

"similarity":"180.0"

)

（2）失敗響應

"result":"-1",

"resultDetall":"比對失敗

)

4.1.12出入境證件實名核驗接口

接口描述

此接口適用于個人實名認證，目前支持以下證件核驗身份證、港澳通行證、

臺灣通行證、外籍人士永久居留證

請求地址

操作操作名稱

方式REST

地址https:〃應用地址/interfaces/checkldentify/

請求參數

參數名中文描述類型是否必填

params業務參數，明文參數格式為json0數據

固定格式如下

(

"paperstype":"1",

"name":"賴勇強”，

"papersnumber":

"cardstartime":o",String必填

"cardendtime":

"ndLion";"CHN"

)

注意：params需要用AES加密方式進

行加密后傳輸。加密秘鑰為

WKXZilc3ble80hUm(即應用密鑰)

params具體參數如下：

字段數據類型字段說明

namestring個人姓名

cardstartimeString證件領取時間

cardendtimeString證件到期時間

nationString國籍

證件類型（默認為1）

1身份證

3港澳通行證

paperstypeString

4臺灣通行證

5外籍人士永久居留證

papersnumberstring個人證件號碼

返回參數

參數名中文描述

retcode返回碼（000000為成功，其他為失敗，詳情可見公共返回碼說明）

msg返回說明

返回實例

（1）成功響應

"retcode":"000000".

“msg”:“實名成功”}

(2)失敗響應

"retcode":"000001",

實名失敗”

}

測試參數：

密文：

f9047a6ca483193de8960c3c1ba7a6ef63c599d13cf85847ddcda3c3a321ecfa4b592ef586bbi9b27a3fde

6464b80b219e18f4a8f1224fd564423f641393eda7b1fc520278cd94a8d34a68ed8f2414eb41fd4ec9fccdc

9b3703a04941f11349ea2fe2db3e0d919431bb12681a4c61c897deed5fd0540d7c9ea7eb092ad70ae9

明文：

(

"paperstype":"1",

"name":"賴勇強”，

"papersnumber":

"cardstartime":

"cardendtime":

"nation":"CHN"

）

4.2、法人服務接口定義

4.2.1綁定企業接口（個人升級法人）

421.1接口描述

該接口用于個人綁定企業后，創建法人賬號，并添加綁定關系。

請求地址

操作操作名稱

方式REST

地址https:〃應用地址/jisapi/

請求參數

參數名中文描述類型是否必填

appmark應用標識String必填

params