全國(guó)公民身份信息系統(tǒng)Web服務(wù)接口調(diào)用規(guī)范V1.9-1092
全國(guó)公民身份信息系統(tǒng)（NCIIS ）Web 服務(wù)接口調(diào)用規(guī)范全國(guó)公民身份證號(hào)碼查詢(xún)服務(wù)中心2014年1月第 1 頁(yè) 共 25 頁(yè) ,目錄第一章第二章第三章3.1第四章4.1
全國(guó)公民身份信息系統(tǒng)
（NCIIS ）
Web 服務(wù)接口調(diào)用規(guī)范
全國(guó)公民身份證號(hào)碼查詢(xún)服務(wù)中心
2014年1月
第 1 頁(yè) 共 25 頁(yè)
,目錄
第一章
第二章
第三章
3.1
第四章
4.1
4.2
第五章
5.1
5.2
第六章
第七章
7.1
7.2
7.3
第八章 概述 ............................................................................................................ 3 文檔描述 ..................................................................................................... 4 術(shù)語(yǔ)和定義.................................................................................................. 5 縮略語(yǔ) . ........................................................................................................ 5 基本框架 ..................................................................................................... 6 概念模型 ..................................................................................................... 6 應(yīng)用場(chǎng)景 ..................................................................................................... 6 接口定義 ..................................................................................................... 7 服務(wù)條件模板獲取 . ...................................................................................... 7 WS 號(hào)碼姓名核查比對(duì)（支持單條和批量） ............................................... 8 HTTPS 設(shè)置 . ............................................................................................. 15 客戶端調(diào)用說(shuō)明示例 ................................................................................. 18 XFIRE 介紹 . .............................................................................................. 18 客戶端訪問(wèn)代碼示例 ................................................................................. 19 常見(jiàn)問(wèn)題描述 ............................................................................................ 24 其他 .......................................................................................................... 25
第 2 頁(yè) 共 25 頁(yè)
,第一章 概述
全國(guó)公民身份信息系統(tǒng)是以全國(guó)公安人口信息管理系統(tǒng)提供的數(shù)據(jù)為基礎(chǔ)，通過(guò)互聯(lián)網(wǎng)和行業(yè)專(zhuān)網(wǎng)向政府部門(mén)、社會(huì)各界、人民群眾依法提供公民身份信息服務(wù)。公民身份信息核查是全國(guó)公民身份信息系統(tǒng)(NCIIS)的主要功能，是系統(tǒng)對(duì)外服務(wù)的核心業(yè)務(wù)。Web 服務(wù)接口為典型的行業(yè)客戶提供了使用全國(guó)公民身份信息系統(tǒng)的訪問(wèn)接口，該接口透明的代理了NCIIS 現(xiàn)有功能，為客戶基于二次開(kāi)發(fā)并將NCIIS 現(xiàn)有功能集成到自身業(yè)務(wù)系統(tǒng)提供了技術(shù)基礎(chǔ)。本W(wǎng)eb 服務(wù)接口的設(shè)計(jì)與實(shí)現(xiàn)遵循目前 Web Services主流技術(shù)架構(gòu)，滿足開(kāi)放系統(tǒng)的標(biāo)準(zhǔn)化規(guī)范要求。
第 3 頁(yè) 共 25 頁(yè)
,第二章 文檔描述
本文檔用于說(shuō)明客戶端調(diào)用全國(guó)公民身份信息系統(tǒng)Web 服務(wù)接口規(guī)范。用于進(jìn)行相關(guān)人口信息資源的核查訪問(wèn)。
如客戶端使用Java 語(yǔ)言實(shí)現(xiàn)，建議使用xFire 實(shí)現(xiàn)，且版本(xFire1.2.6)需與服務(wù)端相同，調(diào)用方式參見(jiàn)第八章客戶端調(diào)用說(shuō)明示例。
如客戶端使用非Java 語(yǔ)言實(shí)現(xiàn)，具體實(shí)現(xiàn)方式請(qǐng)參見(jiàn)第三方開(kāi)發(fā)語(yǔ)言技術(shù)文檔。
1．接口描述文檔WSDL
如需獲取客戶接入服務(wù)平臺(tái)Web Services的接口描述，可以訪問(wèn)以下網(wǎng)址：
其中，ipAddress 為全國(guó)公民身份信息系統(tǒng)開(kāi)通的客戶接入服務(wù)器地址(域名為：api.nciic.com.cn ) 。
此WSDL 文檔描述了客戶接入服務(wù)WebServices 的全部細(xì)節(jié)和調(diào)用的方法。包括消息的格式、傳輸協(xié)議和服務(wù)地址等。
2．WSDL 文檔的解析
作為服務(wù)請(qǐng)求者的客戶為順利與客戶接入服務(wù)WebServices 交互，必須首先獲取該WSDL 文檔，并正確解析得到輸入輸出的各對(duì)象類(lèi)。
WSLD 文檔的獲取，在IE 地址中輸入：
將頁(yè)面保存成一個(gè)文件（即*.wsdl）。因?yàn)椴捎玫氖莌ttps 協(xié)議，所以需要對(duì)此文件內(nèi)容進(jìn)行微小的調(diào)整。通過(guò)文本編輯工具打開(kāi)此文件，在文件內(nèi)容的倒數(shù)第四行，即：
location="http://api.nciic.com.cn/nciic_ws/services/NciicServices" location 的值“http ”修改成“https ”，保存此文件即可。 不同的開(kāi)發(fā)平臺(tái)提供了不同的WSDL 自動(dòng)解析工具。如VS.NET 中的WSDL.exe 工具、Borland 公司的Jbuilder 、Bea 公司的Weblogic Workshop等。使用哪一種工具要視集團(tuán)客戶外部應(yīng)用的系統(tǒng)平臺(tái)和開(kāi)發(fā)平臺(tái)具體情況以及客戶的使用習(xí)慣而定。 第 4 頁(yè) 共 25 頁(yè) />，將 第三章 3.1 縮略語(yǔ) 術(shù)語(yǔ)和定義 SOAP WSDL 簡(jiǎn)單對(duì)象訪問(wèn)協(xié)議（Simple Object Access protocol ） Web 服務(wù)描述語(yǔ)言（Web Service Description Language ） XFire Java SOAP框架 第 5 頁(yè) 共 25 頁(yè) 第四章 4.1 概念模型 基本框架 通過(guò)Web 服務(wù)平臺(tái)為各行業(yè)業(yè)務(wù)系統(tǒng)提供業(yè)務(wù)協(xié)作接口和數(shù)據(jù)支撐。如圖所示，客戶端向Web 服務(wù)平臺(tái)發(fā)送規(guī)范的數(shù)據(jù)訪問(wèn)請(qǐng)求（SOAP 請(qǐng)求），Web 服務(wù)平臺(tái)接收數(shù)據(jù)訪問(wèn)請(qǐng)求后調(diào)用服務(wù)層完成請(qǐng)求處理，并將處理結(jié)果返回給客戶端（SOAP 響應(yīng)）。 4.2 應(yīng)用場(chǎng)景 客戶端根據(jù)服務(wù)請(qǐng)求的接口定義規(guī)范，開(kāi)發(fā)服務(wù)請(qǐng)求應(yīng)用程序訪問(wèn)所提供的服務(wù)。 說(shuō)明： 1. 客戶信息的驗(yàn)證通過(guò)授權(quán)文件參數(shù)來(lái)完成。授權(quán)文件在合同簽署后會(huì)使用郵件等方式發(fā)送到客戶手中（為加密格式）?？蛻粼诮涌谡{(diào)用時(shí)將授權(quán)文件中讀取的字符串作為服務(wù)調(diào)用時(shí)的一個(gè)接口參數(shù)傳遞給服務(wù)器端，服務(wù)端接收后通過(guò)授權(quán)文件內(nèi)容進(jìn)行身份驗(yàn)證。授權(quán)文件的內(nèi)容包括：客戶、用戶、帳號(hào)、密碼、IP 地址、具體調(diào)用的服務(wù)。 2. 采用SOAP1.2作為消息的封裝格式進(jìn)行服務(wù)請(qǐng)求，服務(wù)端接收到請(qǐng)求后進(jìn)行驗(yàn)證，驗(yàn)證通過(guò)后以SOAP1.2作為消息的封裝返回服務(wù)響應(yīng)內(nèi)容。 第 6 頁(yè) 共 25 頁(yè) 第五章 5.1 服務(wù)條件模板獲取 接口定義 接口名稱(chēng)：nciicGetCondition 傳入?yún)?shù)：String inLicense 參數(shù)說(shuō)明： 注意： License 文件會(huì)在簽署合同后通過(guò)郵件等其他形式得到，License 文件本身為加密格式，請(qǐng)參考示例代碼編寫(xiě)客戶端。如果授權(quán)文件中，參數(shù)：客戶ID 、用戶ID 、帳號(hào)ID 、密碼（登錄口令）、服務(wù)ID 發(fā)生變化，則需要重新生成一個(gè)新的授權(quán)文件。 A ）、正常返回結(jié)果： - - - 第 7 頁(yè) 共 25 頁(yè) - 注意： 1、通過(guò)授權(quán)文件驗(yàn)證，調(diào)用nciicGetCondition 方法獲取到的條件模版xml 文件。填寫(xiě)數(shù)據(jù)時(shí)，依據(jù)此模版xml 填寫(xiě)（詳細(xì)說(shuō)明請(qǐng)參看：inConditions 參數(shù)說(shuō)明）。 B ）、異常返回結(jié)果： - 5.2 WS 號(hào)碼姓名核查比對(duì)（支持單條和批量） 5.2.1. 功能描述 為獲得WEBSERVICE 服務(wù)許可證的客戶提供人口信息快速身份核查比對(duì)服務(wù)。根據(jù)身份證號(hào)等信息核查比對(duì)系統(tǒng)內(nèi)有無(wú)相匹配的人的基本信息，若存在則返回存在記錄數(shù)，否則返回零條。分為單條核查比對(duì)和批量核查比對(duì)兩種方式進(jìn)行核查，單條核查比對(duì)只能核查一條記錄的信息，批量核查比對(duì)則可以核查多條記錄的信息，批量核查比對(duì)最多可核查200條記錄。 5.2.2. 接口與參數(shù) 接口名稱(chēng)：nciicCheck 返回值： String resultXML 1：正常返回一個(gè)XML 介質(zhì)的字符串； 2：錯(cuò)誤返回一個(gè)XML 介質(zhì)的字符串； 第 8 頁(yè) 共 25 頁(yè) 傳入?yún)?shù)：String inLicense String inConditions 參數(shù)說(shuō)明： A ）、inLicense 參數(shù)說(shuō)明： 注意： License 文件會(huì)在簽署合同后通過(guò)郵件等其他形式得到，License 文件本身為加密格式，請(qǐng)參考示例代碼編寫(xiě)客戶端。如果授權(quán)文件中，參數(shù)：客戶ID 、用戶ID 、帳號(hào)ID 、密碼（登錄口令）、服務(wù)ID 發(fā)生變化，則需要重新生成一個(gè)新的授權(quán)文件。 B ）、inConditions 參數(shù)說(shuō)明： - --> - - 第 9 頁(yè) 共 25 頁(yè) - 注意： 1、用戶唯一識(shí)別碼：客戶填寫(xiě)各自的業(yè)務(wù)帳號(hào)，集團(tuán)用戶可填寫(xiě)各自的小帳號(hào)，最大長(zhǎng)度40（20個(gè)漢字）。 業(yè)務(wù)發(fā)生地：客戶給自己的客戶辦理業(yè)務(wù)時(shí)的所在地，是6位的行政區(qū)劃編碼，最大長(zhǎng)度6（可以填寫(xiě)3個(gè)漢字）。例如：某某銀行北京市朝陽(yáng)區(qū)青年路支行，此支行所在地即為業(yè)務(wù)發(fā)生地。 業(yè)務(wù)類(lèi)型：客戶給自己的客戶辦理業(yè)務(wù)時(shí)，屬于哪種業(yè)務(wù)類(lèi)型，最大長(zhǎng)度40（可以填寫(xiě)20個(gè)漢字）。例如：某某銀行北京市朝陽(yáng)區(qū)青年路支行給市民辦理開(kāi)戶、貸款、繳費(fèi)等業(yè)務(wù)，此時(shí)辦理的業(yè)務(wù)名稱(chēng)即為業(yè)務(wù)類(lèi)型。 2、inConditions 條件xml 串中，必須輸入數(shù)據(jù)項(xiàng)：公民身份號(hào)碼、姓名、用戶唯一識(shí)別碼、業(yè)務(wù)發(fā)生地、業(yè)務(wù)類(lèi)型。 3、結(jié)果xml 串中的返回：公民身份號(hào)碼、姓名核查結(jié)果，以及照片（Base64編碼）。 C）、提交XML 介質(zhì)字符串inConditions （樣例）： XML 介質(zhì)字符串中的數(shù)據(jù)是虛擬信息。 第 10 頁(yè) 共 25 頁(yè)
