全国公民身份信息系统

（NCIIS）

Web服务接口调用规范

全国公民身份证号码查询服务中心

2014年1月

第1页共25页

目录

第一章

第二章

第三章

3.1

第四章

4.1

4.2

第五章

5.1

5.2

第六章

第七章

7.1

7.2

7.3

第八章概述............................................................................................................3文档描述.....................................................................................................4术语和定义..................................................................................................5缩略语.........................................................................................................5基本框架.....................................................................................................6概念模型.....................................................................................................6应用场景.....................................................................................................6接口定义.....................................................................................................7服务条件模板获取.......................................................................................7WS号码姓名核查比对（支持单条和批量）...............................................8HTTPS设置..............................................................................................15客户端调用说明示例.................................................................................18XFIRE介绍...............................................................................................18客户端访问代码示例.................................................................................19常见问题描述............................................................................................24其他..........................................................................................................25

第2页共25页

第一章概述

全国公民身份信息系统是以全国公安人口信息管理系统提供的数据为基础，通过互联网和行业专网向政府部门、社会各界、人民群众依法提供公民身份信息服务。公民身份信息核查是全国公民身份信息系统(NCIIS)的主要功能，是系统对外服务的核心业务。Web服务接口为典型的行业客户提供了使用全国公民身份信息系统的访问接口，该接口透明的代理了NCIIS现有功能，为客户基于二次开发并将NCIIS现有功能集成到自身业务系统提供了技术基础。本Web服务接口的设计与实现遵循目前WebServices主流技术架构，满足开放系统的标准化规范要求。

第3页共25页

第二章文档描述

本文档用于说明客户端调用全国公民身份信息系统Web服务接口规范。用于进行相关人口信息资源的核查访问。

如客户端使用Java语言实现，建议使用xFire实现，且版本(xFire1.2.6)需与服务端相同，调用方式参见第八章客户端调用说明示例。

如客户端使用非Java语言实现，具体实现方式请参见第三方开发语言技术文档。

1．接口描述文档WSDL

如需获取客户接入服务平台WebServices的接口描述，可以访问以下网址：

其中，ipAddress为全国公民身份信息系统开通的客户接入服务器地址(域名为：api.nciic.com.cn)。

此WSDL文档描述了客户接入服务WebServices的全部细节和调用的方法。包括消息的格式、传输协议和服务地址等。

2．WSDL文档的解析

作为服务请求者的客户为顺利与客户接入服务WebServices交互，必须首先获取该WSDL文档，并正确解析得到输入输出的各对象类。

WSLD文档的获取，在IE地址中输入：

将页面保存成一个文件（即*.wsdl）。因为采用的是https协议，所以需要对此文件内容进行微小的调整。通过文本编辑工具打开此文件，在文件内容的倒数第四行，即：

location="http://api.nciic.com.cn/nciic_ws/services/NciicServices"location的值“http”修改成“https”，保存此文件即可。

不同的开发平台提供了不同的WSDL自动解析工具。如VS.NET中的WSDL.exe工具、Borland公司的Jbuilder、Bea公司的WeblogicWorkshop等。使用哪一种工具要视集团客户外部应用的系统平台和开发平台具体情况以及客户的使用习惯而定。

第4页共25页/>，将

第三章

3.1缩略语术语和定义

SOAP

WSDL简单对象访问协议（SimpleObjectAccessprotocol）Web服务描述语言（WebServiceDescriptionLanguage）XFireJavaSOAP框架

第5页共25页

第四章

4.1概念模型基本框架

通过Web服务平台为各行业业务系统提供业务协作接口和数据支撑。如图所示，客户端向Web服务平台发送规范的数据访问请求（SOAP请求），Web服务平台接收数据访问请求后调用服务层完成请求处理，并将处理结果返回给客户端（SOAP响应）。

4.2应用场景

客户端根据服务请求的接口定义规范，开发服务请求应用程序访问所提供的服务。

说明：

1.客户信息的验证通过授权文件参数来完成。授权文件在合同签署后会使用邮件等方式发送到客户手中（为加密格式）。客户在接口调用时将授权文件中读取的字符串作为服务调用时的一个接口参数传递给服务器端，服务端接收后通过授权文件内容进行身份验证。授权文件的内容包括：客户、用户、帐号、密码、IP地址、具体调用的服务。

2.采用SOAP1.2作为消息的封装格式进行服务请求，服务端接收到请求后进行验证，验证通过后以SOAP1.2作为消息的封装返回服务响应内容。

第6页共25页

第五章

5.1服务条件模板获取接口定义

接口名称：nciicGetCondition

传入参数：StringinLicense

参数说明：

…

…

…

…

…

…

注意：

License文件会在签署合同后通过邮件等其他形式得到，License文件本身为加密格式，请参考示例代码编写客户端。如果授权文件中，参数：客户ID、用户ID、帐号ID、密码（登录口令）、服务ID发生变化，则需要重新生成一个新的授权文件。

A）、正常返回结果：

-

******

-

公民身份号码

姓名

-

XXXXXX

XXXXXX

第7页共25页

-

XXXXXX

XXXXXX

注意：

1、通过授权文件验证，调用nciicGetCondition方法获取到的条件模版xml文件。填写数据时，依据此模版xml填写（详细说明请参看：inConditions参数说明）。

B）、异常返回结果：

---

xxx

xxxxxxxxx

5.2WS号码姓名核查比对（支持单条和批量）

5.2.1.功能描述

为获得WEBSERVICE服务许可证的客户提供人口信息快速身份核查比对服务。根据身份证号等信息核查比对系统内有无相匹配的人的基本信息，若存在则返回存在记录数，否则返回零条。分为单条核查比对和批量核查比对两种方式进行核查，单条核查比对只能核查一条记录的信息，批量核查比对则可以核查多条记录的信息，批量核查比对最多可核查200条记录。

5.2.2.接口与参数

接口名称：nciicCheck

返回值：StringresultXML

1：正常返回一个XML介质的字符串；

2：错误返回一个XML介质的字符串；

第8页共25页

传入参数：StringinLicense

StringinConditions

参数说明：

A）、inLicense参数说明：

…

…

…

…

…

…

注意：

License文件会在签署合同后通过邮件等其他形式得到，License文件本身为加密格式，请参考示例代码编写客户端。如果授权文件中，参数：客户ID、用户ID、帐号ID、密码（登录口令）、服务ID发生变化，则需要重新生成一个新的授权文件。

B）、inConditions参数说明：

-

******

-->

-姓名

-

第9页共25页

XXXXXX

XXXXXX

-

XXXXXX

XXXXXX

注意：

1、用户唯一识别码：客户填写各自的业务帐号，集团用户可填写各自的小帐号，最大长度40（20个汉字）。

业务发生地：客户给自己的客户办理业务时的所在地，是6位的行政区划编码，最大长度6（可以填写3个汉字）。例如：某某银行北京市朝阳区青年路支行，此支行所在地即为业务发生地。

业务类型：客户给自己的客户办理业务时，属于哪种业务类型，最大长度40（可以填写20个汉字）。例如：某某银行北京市朝阳区青年路支行给市民办理开户、贷款、缴费等业务，此时办理的业务名称即为业务类型。

2、inConditions条件xml串中，必须输入数据项：公民身份号码、姓名、用户唯一识别码、业务发生地、业务类型。

3、结果xml串中的返回：公民身份号码、姓名核查结果，以及照片（Base64编码）。

C）、提交XML介质字符串inConditions（样例）：

XML介质字符串中的数据是虚拟信息。

zxjfyhjk12345

公民身份号码

姓名

36242219521230***

第10页共25页