湖北省生物特征識別管理平臺接口標準

附件4

湖北省生物特征識別

信息管理平臺

接口標準

系統(tǒng)測試地址：http://l3:7011/hbscrz/login.jsp

服務測試地址：3:7011/hbScrzService/services/ScrzService?wsdl

系統(tǒng)正式地址：5/hbscrz/login.jsp

服務正式地址：5/hbScrzService/services/ScrzService?wsdl

技術咨詢：

毛榜國13631218999@163.com

秦靖yuanmu2006@163.com

201g與3月

目錄

1接口說明........................................................錯誤味定義書簽。

1.1JAVA1.6調用WEBSERVICES示例.............................................-1-

1.2明文傳輸和密文傳輸.....................................................-1-

1.3JAVA中ASE加密示例....................................................-2-

1.4查詢接口...............................................................-3-

1.5建模接口...............................................................-7-

1.6待遇領取資格查詢........................................錯誤!未定義書簽。

1.7修改接口密碼..........................................................-13-

湖北省生物特征識別管理信息系統(tǒng)接口標準

1接口調用說明

1.1JAVA1.6調用WebServices示例

在JAVA1.6中，用下面例子可以調用系統(tǒng)提供的WebService接口。

.URL;

importjavax.xmLnamespace.QName;

importorg.apache.axis.client.Call;

importorg.apache.axis.client.Service;

Callcall=(Call)(newService()).createCall();

call.setTargetEndpointAddress(newURL("http://*.*.*.*:7001/hbScrzService/services/ScrzServicen));

call.setOperationName(newQName("/axis2",',authen"));

call.setTimeout(30000);

Stringre=(String)caIl.invoke(newString[]{M......."});

System.out.println(re);

1.2明文傳輸和密文傳輸

本系統(tǒng)接口支持明文調用和密文調用，具體請參見每個函數(shù)說明中的“密碼

發(fā)送"和“密文返回”部分的說明。

系統(tǒng)約定，當應用方以明文請求時，系統(tǒng)以明文返回；當應用方以密文請求

時，系統(tǒng)以密文返回。

本系統(tǒng)采用AES對稱加密算法。不論加減密，明文字符串均以UTF-8進行轉

換，密文統(tǒng)一轉換為16進制字符串。

加解密的密鑰按接口用戶進行獨立分配，一個用戶一個密鑰，由接口使用方

向人社廳信息中心申請。

下面是算法測試用的密鑰、明文和密文。

密鑰：123456789012345678901234(這是測試環(huán)境中所有用戶使用的測試密

鑰)

明文：1234567890中華人民共和國abcdefghijklmnopqrstuvwxyz

-1-

湖北省生物特征識別管理信息系統(tǒng)接口標準

密文：5EDB444FDA8F4757DF79971ABF008F20A4A4724F7A56B9CA14DA5AA7FED149D31C88

8AF3A8EFEE5500B2C00E1C923088CB8174B0DE852B8F4AE53B238651AEF2

1.3JAVA中ASE加密示例

importjavax.crypto.Cipher;

importjavax.crypto.KeyGenerator;

importjavax.crypto.SecretKey;

importjavax.crypto.spec.SecretKeySpec;

importjava.security.SecureRandom;

publicclassASETest{

/**

*@paramargs

*/

publicstaticStringbytes2hex(byte[]bytes)

(

finalStringHEX=',0123456789ABCDEF";

StringBuildersb=ncwStringBuildcr(bytes.lcngth*2);

for(byteb:bytes)

(

//取出這個字節(jié)的高4位，然后與OxOf與運算，得到一個0-15之間的數(shù)據(jù)，通過HEX.charAt(0-15)即為16

進制數(shù)

sb.append(HEX.charAt((b?4)&0x0F));

//取出這個字節(jié)的低位，與OxOf與運算，得到?個0-15之間的數(shù)據(jù)，通過HEX.charAt(0-l5)即為16進制

數(shù)

sb.append(HEX.charAt(b&OxOF));

)

retumsb.toStringO;

)

publicstaticvoidmain(String[]args){

//TODOAuto-generatedmethodstub

Stringrc=',n;

-2-

湖北省生物特征識別管理信息系統(tǒng)接口標準

Stringpass=”123456789012345678901234”；

Strings="1234567890中華人民共和國abcdefghijklmnopqrstuvwxyz";

try)

KeyGeneratorkgen=KeyGenerator.getInstance("AES");

kgen.init(l28,newSecureRandom(pass.getBytes()));

SccretKcySpcckey=newSecrctKeySpec(kgcn.generateKey().getEncoded(),"AES");

Cipherciphe尸Cipher.gelInstance("AES");

cipher.init(Cipher.ENCRYPT_MODE,key);

bytc[]bb=ciphcr.doFinal(s.gctBytes("UTF-8"));

re=bytes2hex(bb);

System.out.print(re);

1

catch(Exceptionex){};

)

)

2認證服務接口

2.1查詢接口alIJK?ID*＞查詢＜/ID*＞......)

省生存認證平臺提供查詢接口，供生物特征識別系統(tǒng)調用查詢?nèi)藛T基本信

息、人員相片及人員生物特征模板信息。

社會保障號碼、設備分類ID、設備物理ID作為輸入?yún)?shù)調用生存認證平臺

的查詢接口，平臺在數(shù)據(jù)庫中按社會保障號碼查詢到該人員所有數(shù)據(jù)，將人員基

本信息數(shù)據(jù)、相片數(shù)據(jù)、生物特征模板數(shù)據(jù)返回，否則返回錯誤信息。

【查詢接口功能描述】

接口名稱查詢接口

提供查詢接口，用于對人員的基本信息、相片信息、生物特征模板信息進

功能描述

行查詢

接口分類

通信方式WebService服務接口

操作流程生物特征識別系統(tǒng)調用省生存認證平臺的查詢接口，查詢省生存認證平臺

-3-

湖北省生物特征識別管理信息系統(tǒng)接口標準

數(shù)據(jù)庫中該人員的基本信息數(shù)據(jù)、相片數(shù)據(jù)、生物特征模板數(shù)據(jù)，將所有

數(shù)據(jù)返回，未查詢到則返回錯誤信息

安全說明

【輸入數(shù)據(jù)】

數(shù)據(jù)條目數(shù)據(jù)項

1ID,固定為“查詢”

2接口用戶名

3接口用戶密碼

4設備分類ID

5設備物理ID

6社會保障號碼

【關鍵數(shù)據(jù)項描述】

數(shù)據(jù)項類型長度允許空值參數(shù)描述補充說明

接口用戶名字符型20非空

接口用戶密碼字符型20非空由系統(tǒng)分配

設備分類ID字符型20有設備時不能為空

設備物理ID字符型20有設備時不能為空

社會保障號碼字符型20非空

【輸出數(shù)據(jù)】

數(shù)據(jù)條目數(shù)據(jù)項

1返回信息

2社會保障號碼

3姓名

4性別

5民族

6出生日期

7人員狀態(tài)

8戶口性質

-4-

湖北省生物特征識別管理信息系統(tǒng)接口標準

9戶口地址

10移動電話

11固定電話

12常住地址

13常住地郵編

14電子郵箱

15單位編號

16單位名稱

17監(jiān)護人姓名

18監(jiān)護人證件類型

19監(jiān)護人證件號碼

20所屬機構

21受托機構

22受托地電話

23受托地地址

24認證時間

25認證周期

26生物特征模板

27相片

【關鍵數(shù)據(jù)項描述】

數(shù)據(jù)項類型長度參數(shù)描述補充說明

返回信息字符型不定長返回“00”時，表示查詢成功，后

續(xù)數(shù)據(jù)域有效;否則返回值即為錯

誤信息。

社會保障號碼字符型20

姓名字符型50

性別字符型1代碼

民族字符型2代碼

出生日期字符型8

-5-

湖北省生物特征識別管理信息系統(tǒng)接口標準

人員狀態(tài)字符型1代碼

戶口性質字符型2代碼

戶口地址字符型150

移動電話字符型20

固定電話字符型20

常住地址字符型150

常住地郵編字符型6

電子郵箱字符型30

單位編號字符型20

單位名稱字符型100

監(jiān)護人姓名字符型50

監(jiān)護人證件類型字符型2代碼

監(jiān)護人證件號碼字符型22

所屬機構字符型20

受托機構字符型20

受托地電話字符型20

受托地地址字符型150

認證時間數(shù)值型14格式為YYYYMMDDHHMMSS

認證周期數(shù)值型2

生物特征模板字符型10K

相片字符型50KBASE64編碼的人員相片

【查詢接口調用標準】

通過社會保障號碼查詢?nèi)藛T信息和相片，通過設備分類ID查詢最新一次在該類設備上

采集的模型數(shù)據(jù)。

調用參數(shù)：<ID*>查詢v/ID*><USER*>429900</USER*><PASS*><：/PASS*><TYPEID></

TYPEIDxDEVICEIDx/DEVICEIDxAAC002*>l11111198101011110</AAC002*>

序數(shù)據(jù)域類型長度說明備注

1ID*字符<=20固定為“查詢”

2USER*字符<=20接口用戶名

-6-

湖北省生物特征識別管理信息系統(tǒng)接口標準

3PASS*字符<=20接口用戶密碼

4TYPEID字符<=20設備分類ID有設備時不能為空

5DEVICEID字符<=20設備物理ID有設備時不能為空

7AAC002*字符<二20社會保障號碼身份證號

接口用戶名、接口用戶密碼，由生物特征識別管理系統(tǒng)分配，密碼可以由本章接口進行

修改。帶有*號的數(shù)據(jù)項不能為空，其他數(shù)據(jù)項當有設備時不能為空。

返回：<ERROR>00/失敗原因</ERROR><DATEO>yyyy-mm-ddhh:mm:ss/空</DATEO><D

ATEl>yyyy-mm-dd之前/空</DATEl><TYPEID></TYPEID><DEVICEID></DEVICEID><社

?？ㄌ?gt;</社?？ㄌ?gt;<社會保障號碼>lt;/社會保障號碼><姓名>姓名1</

姓名〉<性別>1</性別><民族>01</民族><出生日期>19800101</出生日期>〈人員狀態(tài)〉1</人

員狀態(tài)><戶口性質>11</戶口性質><戶口地址></戶口地址><移動電話>00000000000</移動

電話>〈固定電話>電話1</固定電話>〈常住地址>通訊地址1</常住地址><郵政編碼></郵政

編碼><電子郵箱>111@111.com</電子郵箱><單位編號〉單位編號1</單位編號><單位名稱>

單位名稱1</單位名稱><監(jiān)護人姓名></監(jiān)護人姓名><監(jiān)護人證件類型></監(jiān)護人證件類型〉

〈監(jiān)護人證件號碼></監(jiān)護人證件號碼><所屬機構>42990001〈/所屬機構><受托機構></受托

機構><受托地電話></受托地電話><受托地住址></受托地住址><認證時間></認證時間><

認證周期>12〈/認證周期"描述></描述><模型></模型><相片“湘片>

當返回的“ERROR”域為00,返回的其他各域有效，否則“ERROR”域中為出錯信息。

當人員信息不存在時返回出錯信息，當人員信息存在時不論模型是否存在都會返回成功信

息。返回信息中與模型相關的數(shù)據(jù)項為空時表示指定人員在指定類型的設備上無模型。<DA

TE0>域返回的是上次認證的時間（不一定是指定的認證模式，格式為：yyyy-mm-ddhh:mm:

ss）,<DATE1>域返回的是下次認證的時間（格式為：yyyy-mm-dd之前）。

密文發(fā)送：<ID*>查詢</ID*><USER*>user</USER*><MM>mm</MM>。"MM"域是發(fā)

送的密文，密文的加密范圍是明文形式參數(shù)的完整串，密文以16進制編碼?！癕M”域的值

不空為密文調用，否則為明文調用。

密文返回：<MM>re-mm</MM>?！癕M”域是返回的密文，密文的加密范圍是明文形式

返回的完整串，密文以16進制編碼。

2.2建模接口allJK（<ID*>建模</ID*>……）

省生存認證平臺提供建模接口，供生物特征識別系統(tǒng)調用，在完成生物特征

-7-

湖北省生物特征識別管理信息系統(tǒng)接口標準

信息采集后將生物特征模板數(shù)據(jù)上傳到生存認證平臺中。

【建模接口功能描述】

接口名稱建模接口

生物特征識別系統(tǒng)完成生物特征信息采集后將生物特征模板數(shù)據(jù)上傳到

功能描述

省生存認證平臺中

接口分類

通信方式WebService服務接口

生物特征識別系統(tǒng)在完成生物特征信息采集后，調用省生存認證平臺的建

操作流程模接口，將生物特征模板數(shù)據(jù)上傳到省生存認證平臺中，省生存認證平臺

成功保存模板數(shù)據(jù)后返回成功信息，否則返回錯誤信息

安全說明

【輸入數(shù)據(jù)】

數(shù)據(jù)條目數(shù)據(jù)項

1ID,固定為“建?！?/p>

2接口用戶名

3接口用戶密碼

4操作員所屬機構

5操作員社會保障號碼

6操作員姓名

7設備分類ID

8設備物理ID

9社會保障號碼

10姓名

11建模時間

12生物特征模板描述

13生物特征模板

14生物特征圖像

15數(shù)據(jù)交換圖像

【關鍵數(shù)據(jù)項描述】

-8-

湖北省生物特征識別管理信息系統(tǒng)接口標準

數(shù)據(jù)項類型長度允許空值參數(shù)描述補充說明

接口用戶名字符型20非空

接口用戶密碼字符型20非空由系統(tǒng)分配

認證平臺機構或“自

操作員所屬機構字符型20非空

助”

認證平臺操作員或

操作員社會保障號碼字符型20非空

“自助”

認證平臺操作員或

操作員姓名字符型50非空

“自助”

設備分類ID字符型20非空

設備物理ID字符型20非空

社?？ㄌ栕址?0

社會保障號碼字符型20非空

姓名字符型50

YYYYMMDDHHmmSS或

建模時間數(shù)字型14非空

“T”用系統(tǒng)時間

生物特征模板描述字符型20非空手指等的編號

生物特征模板字符型10K非空

本次建模有代表性的

生物特征圖像字符型50K一張?zhí)卣鲌D像，

BASE64編碼

數(shù)據(jù)交換圖像字符型50K建模的全部圖像

特征圖像：本次建模所采集的其中一張?zhí)卣鲌D像，盡量取比較有代表性、而且便于人工

識別的圖像.圖像采作BASE64編碼，并去除編碼中的所有分隔符。收集特征圖像主要用于

人工追訴時分析使用。

數(shù)據(jù)交換圖像：本次建模所采集的全部圖像，圖像存儲格式符合人社部《生物識別技術

圖像交換標準》，此字段為預設字段。

【輸出數(shù)據(jù)】

-9-

湖北省生物特征識別管理信息系統(tǒng)接口標準

數(shù)據(jù)條目數(shù)據(jù)項

1返回信息

【關鍵數(shù)據(jù)項描述】

數(shù)據(jù)項類型長度參數(shù)描述補充說明

返回信息字符型不定長當＜ERROR＞1^返回00表示特征

數(shù)據(jù)提交成功并認證成功（視為一

次認證），在＜DATA1＞域中會返回

下次認證時間（格式為：

yyyy-mm-dd之前）:否則返回值即

為錯誤信息。

【建模接口調用標準】

根據(jù)查詢接口中得到的個人信息按設備類型建立認證模型，通過本接口提交建立的認證

模型數(shù)據(jù)，一次建模同時視為一次認證。

調用參數(shù)：<ID*>建模</ID*>vUSER*>429900</USER*>vPASS*></PASS*><CZYJG*>v/

CZYJG*>vCZYSFZ*></CZYSFZ*><CZYXM*></CZYXM*><TYPEID*>B00001v/TYPEID

*><DEVICEID*>00001</DEVICEID*><AAZ500>v/AAZ500><AAC002*>1111111981010111

10</AAC002*xAAC003x/AAC003><RZTIME*>20160120081122</RZTlME*><DEPICT

*>..DEPICT..</DEPICT*><MODEL*>..MODEL..</MODEL*><PICTURE1>..PICTURE1..</PI

CTURE1><PICTURE2>..PICTURE1..</PICTURE2>

序數(shù)據(jù)域類型長度說明備注

1ID*字符<=20固定為“建?！?/p>

2USER*字符<=20接口用戶名

3PASS*字符<=20接口用戶密碼

4CZYJG字符<=20操作員機構認證平臺機構或“自助”

5CZYSFZ字符<=20操作員社會保障號認證平臺操作員或“自助”

6CZYXM字符<=50操作員姓名認證平臺操作員或“自助”

7TYPEID*字符<=20設備分類ID

8DEVICEID*字符<=20設備物理ID

9AAZ500字符<=10社?？ㄌ?/p>

-10-

湖北省生物特征識別管理信息系統(tǒng)接口標準

10AAC002*字符<=20社會保障號碼身份證號

11AAC003字符<=50姓名

12RZTIME*數(shù)值14建模時間YYYYMMDDHHmmSS

或"用系統(tǒng)時間

13DEPICT*字符<=20模型描述手、手指、眼等編號

14MODEL*字符<=10K模型

15PICTURE1字符<=50K特征圖像BASE64編碼

16PICTURE2字符<=50K數(shù)據(jù)交換圖像BASE64編碼

模型描述：建立模型的范圍描述，如指紋、指靜脈左、右手指編號等。掌靜脈的手掌編

號、虹膜的眼睛編號等。建模描述的記錄格式要符合國家和人社部的相關規(guī)范。

模型：建立完成的模型數(shù)據(jù)，要與模型描述相對應。模型數(shù)據(jù)的記錄格式要符合國家和

人社部的相關規(guī)范。

特征圖像：本次建模所采集的其中一張?zhí)卣鲌D像，盡量取比較有代表性、而且便于人工

識別的圖像。圖像采作BASE64編碼，并去除編碼中的所有分隔符。收集特征圖像主要用于

人工追訴時分析使用。

數(shù)據(jù)交換圖像：本次建模所采集的全部圖像，圖像存儲格式符合人社部《生物識別技術

圖像交換標準》，此字段為預設字段。

返回：<ERROR>00/失敗原因</ERROR><DATEl>下次認證時間yyyy-mm-dd之前/空</

DATE1>

當<ERROR>域返回00表示特征數(shù)據(jù)提交成功并認證成功（視為一次認證），在<DATA1>

域中會返回下次認證時間（格式為：yyyy-mm-dd之前），各系統(tǒng)應按這個時間給用戶提示或

打印在相關回執(zhí)中。否則返回失敗原因。

密文發(fā)送：<ID*>建模</ID*><USER*>user</USER*><MM>mm</MM>。"MM"域是發(fā)

送的密文，密文的加密范圍是明文形式參數(shù)的完整串，密文以16進制編碼。“MM”域的值

不空為密文調用，否則為明文調用。

密文返回：<MM>re-mm</MM>。"MM"域是返回的密文，密文的加密范圍是明文形式

返回的完整串，密文以16進制編碼。

2.3認證接口allJK?lD*>認證</1D*>……）

根據(jù)查詢接口中得到的模型進行認證，通過本接口返回認證結果。系統(tǒng)只接

-H-

湖北省生物特征識別管理信息系統(tǒng)接口標準

收認證通過的接口。

調用參數(shù)：<ID*>UiiE</ID*><USER*>429900</USER*><PASS*></PASS*><CZYJG*></CZ

YJG*><CZYSFZ*></CZYSFZ*><CZYXM*x/CZYXM*><TYPEID>B00001</TYPEID><DE

VICEID>00001</DEVICEIDxAAZ500x/AAZ500><AAC002*>l11111198101011110</AAC

002*><AAC003x/AAC003xRZTIME*>20160120081133</RZTIME*><DEPICT1>..DEPICT

1..</DEPICTIxMODELO..MODEL1..</MODEL1xPICTURE1>..PICTURE1..</PICTURE

1>

序數(shù)據(jù)域類型長度說明備注

1ID*字符<=20固定為“認證”

2USER*字符<=20接口用戶名

3PASS*字符<=20接口用戶密碼

4CZYJG字符<=20操作員機構認證平臺機構或“自助”

5CZYSFZ字符<=20操作員社會保障號認證平臺操作員或“自助”

6CZYXM字符<=50操作員姓名認證平臺操作員或“自助”

7TYPEID字符<=20設備分類ID

8DEVICEID字符<=20設備物理ID

9AAZ500字符<=10社保書號

10AAC002*字符<=20社會保障號碼身份證號

11AAC003字符<=50姓名

12RZTIME*數(shù)值14認證時間YYYYMMDDHHmmSS或“T”

用系統(tǒng)時間

13DEPICT1字符<=20認證描述如認證用到的手指

14M0DEL1■字:符<=2K認證模型

15PICTUREl字符<=50K特征圖像BASE64編碼

認證描述：采集認證的對像描述，如實現(xiàn)比對的手指編號等。認證描述的記錄格式參照

“模型描述”，要符合國家和人社部的相關規(guī)范。

認證模型：采集得到的模型數(shù)據(jù)，要與采集描述相對應。認證模型數(shù)據(jù)的記錄格式參照

“模型，，，要符合國家和人社部的相關規(guī)范。

特征圖像：本次認證所采集的其中一張?zhí)卣鲌D像，盡量取比較有代表性、而且便于人工

識別的圖像。收集特征圖像主要用于人工追訴時分析使用。

設備分類ID為空時表示完成一次人工認證，其相關的DEVICEID、DEPICT1、MODEL1、

PICTURE1也必須同時為空。

-12-

湖北省生物特征識別管理信息系統(tǒng)接口標準

返回：＜ERROR＞00佚敗原因＜/ERROR＞＜DATEl＞下次認證時間yyyy-mm-ddhh:mm:ss/

空＜/DATEl＞

當＜ERROR＞域返回00表示認證通過，并在＜DATE1＞域中返回下次認證時間（格式為：

yyyy-mm-dd之前）。否則返回失敗原因。

密文發(fā)送：＜ID*＞認證＜/ID*＞〈USER*＞userv/USER*＞＜MM＞mm＜/MM＞。"MM"域是發(fā)

送的密文，密文的加密范圍是明文形式參數(shù)的完整串，密文以16進制編碼。“MM”域的值

不空為密文調用，否則為明文調用。

密文返回：＜MM＞re-mm＜/MM＞。"MM”域是返回的密文，密文的加密范圍是明文形式

返回的完整串，密文以16進制編碼。

2.4修改接口密碼aIIJK（＜ID*＞修改接口密碼＜/1D*＞……）

省生存認證平臺提供修改接口密碼功能，供生物特征識別系統(tǒng)修改密碼。

【修改接口密碼功能描述】

接口名稱修改接口密碼

功能描述用于修改調用者接口的密碼

接口分類

通信方式WebService服務接口

操作流程生物特征識別系統(tǒng)通過接口參數(shù)調用修改接口密碼接口進行密碼的修改

安全說明

【輸入數(shù)據(jù)】

數(shù)據(jù)條目數(shù)據(jù)項

1ID,固定為“修改接口密碼”

2接口用戶名

3接口用戶密碼

4新密碼

【關鍵數(shù)據(jù)項描述】

數(shù)據(jù)項類型長度允許空值參數(shù)描述補充說明

接口用戶名字符型20非空

接口用戶密碼字符型20非空由系統(tǒng)分配

-13-

湖北省生物特征識別管理信息系統(tǒng)接口標準

新密碼字符型20非空5-20位

【輸出數(shù)據(jù)】

數(shù)據(jù)條目數(shù)據(jù)項

1返回信息

【關鍵數(shù)據(jù)項描述】

數(shù)據(jù)項類型長度參數(shù)描述補充說明

返回信息字符型不定長返回“00”時，表示修改成功；否

則返回值即為錯誤信息。

【修改接口密碼調用標準】

調用參數(shù)：<ID*>修改接口密碼</ID*><USER*></USER*><PASS*></PASS*><NEWP*

></NEWP*>

“USER*"域為接口用戶名，"PASS*"域為原密碼，“NEWP”域為新密碼。新密碼不

能為空，新密碼必須在5-20位之間。

本次調用使用“原密碼”進行驗證。執(zhí)行成功后，從下次調用開始使用“新密碼”進行

驗證。

返回：<ERROR>00佚敗原因</ERROR>

密文發(fā)送：<ID*>修改接口密碼</ID*><USER*>user</USER*><MM>mm</MM>。"MM"

域是發(fā)送的密文，密文的加密范圍是明文形式參數(shù)的完整串，密文以16進制編碼?！癕M”

域的值不空為密文調用，否則為明文調用。

密文返回：<MM>re-mm</MM>?！癕M”域是返回的密文，密文的加密范圍是明文形式

返回的完整串，密文以16進制編碼。

3應用接口函數(shù)

3.1獲取認證狀態(tài)getRZs()

getRZs(user,pass,aac002s)

調用參數(shù)：user接口用戶名，pass由系統(tǒng)分配接口用戶密碼，aacOO2s是用半

角分號分隔的社會保障號碼。

-14-

湖北省生物特征識別管理信息系統(tǒng)接口標準

系統(tǒng)以多行返回。

第1行：<ERR〉OO/出錯信息</ERR>。ERR域返回“00”表示查詢結果有效

，后續(xù)各行是查詢結果。否則ERR域為出錯信息，無后續(xù)數(shù)據(jù)。

第2行：序號,社會保障號碼，姓名，認證時間，認證方式。這是標題行，是對后

續(xù)各行數(shù)據(jù)的說明。

第3行起：正文。

下面是查詢返回的例子：

<ERR>00</ERR>

序號,社會保障號碼，姓名，認證時間，認證方式

1姓名01,20150927114612,00_人工認證

2姓名03,20150927120133,02_指靜脈識別認證

3,2121212121212121,,,

密文發(fā)送：getRZsluser-'mm）。mm是發(fā)送的密文，密文的加密范圍是

<USER>user</USER><PASSx/PASS><AAC002S>aac002s</AAC002S>,密文以16進制編

碼。pass參數(shù)的值空為密文調用，否則為明文調用。

密文返回：<MM>re-mm</MM>?！癕M”域是返回的密文，密文的加密范圍是明文形式

返回的完整串，密文以16進制編碼。

3.2提交人員信息setACOI0

setAC01（Stringxml="<操作*〉提交人員信息〈/操作*〉....”）

通過本接口向認證系統(tǒng)提交人員信息。

調用參數(shù)xml：（操作*〉提交人員信息</操作*><用戶名*>429900V/用戶名

*><密碼*></密碼*><所屬城市*>429900</所屬城市*><所屬機構*>42990001〈/所

屬機構*><社會保障號碼*>/社會保障號碼*><姓名*>姓名

01</姓名*><國家地區(qū)*〉CHN</國家地區(qū)*><證件類型*>01</證件類型*><證件

號碼*>lt;/證件號碼*><證件有效期*>20331121〈/證件有效期

*><性別*>1〈/性別*><民族*>01（/民族*><出生日期*>19800101</出生日期*><

人員狀態(tài)>1〈/人員狀態(tài)><戶口性質>11〈/戶口性質><戶口地址>戶口地址1</戶口

地址><移動電話*>12345678901</移動電話*><固定電話〉電話1〈/固定電話><常

-15-

湖北省生物特征識別管理信息系統(tǒng)接口標準

住地址>常住地址1〈/常住地址><常住地郵編〉123451</常住地郵編><電子郵箱

>111@11Lcom〈/電子郵箱><單位編號〉單位編號1</單位編號><單位名稱〉單位

名稱1〈/單位名稱><職業(yè)工種>1050000〈/職業(yè)工種><監(jiān)護人姓名〉監(jiān)護人1</監(jiān)護

人姓名><監(jiān)護人證件類型>01〈/監(jiān)護人證件類型><監(jiān)護人證號

>111111111111111111</監(jiān)護人證號><認證周期*>12</認證周期*〉

其中的“認證周期”必須在1-36之間，表示認證周期的月數(shù)，認證周期只做

認證時參考，最終的認證是否有效只能以業(yè)務系統(tǒng)的規(guī)則和提示為準。

返回：00/失敗原因。00表示提交成功，失敗時直接返回中文的失敗原因。

密文發(fā)送：(操作*〉提交人員信息</操作*><用戶名*>user</用戶名*><MM>mm</MM>。

“MM”域是發(fā)送的密文，密文的加密范圍是明文形式參數(shù)的完整串，密文以16進制編碼。

“MM”域的值不空為密文調用，否則為明文調用。

密文返回：<MM>re-mm</MM>?！癕M”域是返回的密文，密文的加密范圍是明文形式

返回的完整串，密文以16進制編碼。

3.3提交認證信息setRZ()

setRZ(Stringxml="(操作*〉提交認證信息〈/操作*〉....")

調用參數(shù)xml：(操作*〉提交認證信息</操作*><用戶名*>429900</用戶名

*><密碼*></密碼*><認證機構*></認證機構*><社會保障號碼

*>/社會保障號碼*><姓名*>姓名01</姓名*><認證時間

>20160428090844</認證時間><認證方式>00〈/認證方式><認證數(shù)據(jù)></認證數(shù)據(jù)

>

其中“認證時間”域可以為“-1”表示使用系統(tǒng)當前時間，否則應為14位的

日期時間數(shù)據(jù)(YYYYMMDDHHmmSS)?！罢J證數(shù)據(jù)”域的標準由數(shù)據(jù)提交方

參照前面章節(jié)自行確定，可以是任意的字符串或空。認證方式參見代碼。

返回：00/失敗原因。00表示提交成功，失敗時直接返回中文的失敗原因。

密文發(fā)送：(操作*〉提交認證信息</操作*><用戶名*〉user</用戶名*><MM>mm</MM>。

“MM”域是發(fā)送的密文，密文的加密范圍是明文形式參數(shù)的完整串，密文以16進制編碼。

“MM”域的值不空為密文調用，否則為明文調用。

密文返回：<MM>re-mm</MM>。“MM”域是返回的密文，密文的加密范圍是明文形式

返回的完整串，密文以16進制編碼。

-16-

湖北省生物特征識別管理信息系統(tǒng)接口標準

4常用業(yè)務調用接口方法

4.1獨立設備實時聯(lián)網(wǎng)對接方法（獨立系統(tǒng)聯(lián)機認證）

1.讀社?？ǐ@取個人信息。

2.調用“查詢接口”查詢?nèi)藛T信息和建型信息，人員信息不存在時報錯并終止

認證。

3.如果無模型信息，則實施建模采集，調用“建模接口”完成建模。

4.如果有模型信息，則實施認證采集，調用“認證接口”完成認證。

5.如果有模型信息，還可以給用戶選擇強制重新建模，再調用“建模接口”完

成建模。

4.2舊系統(tǒng)遷入省認證系統(tǒng)（舊系統(tǒng)遷入）

1.從舊系統(tǒng)中，導出所有人員的社會保障號碼。

2.通過省認證系統(tǒng)的“按名單批量提取”功能建立個人基本信息，并對不能提

取的在“個人信息錄入”中補錄個人信息。（或通過接口進行提交）

3.調用省認證系統(tǒng)的“建模接口”將舊系統(tǒng)中最新的模型數(shù)據(jù)傳入省認證系統(tǒng)。

4.調用省認證系統(tǒng)的“認證接口”將舊系統(tǒng)中最新的認證數(shù)據(jù)傳入省認證系統(tǒng)。

5.停用舊認證系統(tǒng)，所有認證和數(shù)據(jù)交互都在省認證系統(tǒng)進行。

舊系統(tǒng)一段時間內(nèi)無法停用的，可考慮認證結果對接的方式，即調用提交認證信息接口

將認證結果上傳至省認證系統(tǒng)。

5系統(tǒng)代碼

5.1機構編碼（參照省卡管系統(tǒng)）

地市代碼

代碼代碼值

420100武漢市

420200黃石市

420300十堰市

420500宜昌市

-17-

湖北省生物特征識別管理信息系統(tǒng)接口標準

420600襄陽市

420700鄂州市

420800荊門市

420900孝感市

421000荊州市

421100黃岡市

421200咸寧市

421300隨州市

422800恩施州

429004仙桃市

429005潛江市

429006天門市

429021神農(nóng)架林區(qū)

429900省直

區(qū)縣和鄉(xiāng)鎮(zhèn)代碼（符合指定條件

的記錄）

代碼代碼值

42010000武漢市養(yǎng)老保險局

4201000002武漢江岸區(qū)

4201000003武漢江漢區(qū)

4201000004武漢研口區(qū)

4201000005武漢漢陽區(qū)

4201000006武漢武昌區(qū)

4201000007武漢青山區(qū)

4201000011