卫计委-全员人口查询接口服务使用说明

1.接口信息接口类型：webservice接口格式：XML接口编码：UTF-8接口地址：01/ws_wjw_qyrksj_cz1.1国家平台认证参数在请求报文的标签中填充接口认证信息：参数名称参数说明gjgxjhpt_rid请求方标识 （请求者标识）gjgxjhpt_sid请求服务标识（接口编码）gjgxjhpt_rtime程序生成 当前调用时间戳gjgxjhpt_sign对应认证环节最后获得的sign。注意这个sign生成之后五分钟有效期。上述参数中需要实时生成，具体生成方法请参考国家共享平台接口认证方式说明文档.docx。1.2接口规范全员人口数据共享服务public String qyrkService (String username, String password, String xmlInput);输入参数说明一级参数描述：参数名称解释长度备注username用户名s.50（wjw）password密码s.50（123456）xmlInput输入参数xml格式的字符串二级参数xmlInput内容描述节点名称内容说明requestinfoxml总体信息描述参数解释长度（备注）requestDate请求时间YYYY-MM-DD HH24:Mi:SSrequestOrgCode接口使用单位代码接口使用单位代码，按照GB/T31286-2014标准提供，长度不超过20字节requestOrgName接口使用单位名称接口使用单位名称，长度不超过60字节body业务数据信息参数解释长度（备注）xm姓名s.50sfz_hm身份证号码an.18qyrkService中xml内容格式 2011-11-10 22:23:34 123456789123456 数据共享平台 张三输出参数：以xml内容格式输出接口响应结果 Xml返回值描述：节点名称内容说明resultinfoxml总体信息描述节点名称解释长度（备注）success处理成功标示：1表示失败，0表示成功n1message处理结果显示信息:成功给出“成功”标识;失败给出“失败”标识； s.20body业务数据处理信息1 、内容错误参数解释长度（备注）errorMsg错误信息明细其中，用户名密码错误返回无权限；xmlInput参数错误，返回xmlInput信息错误2、返回内容参数解释长度（备注）xm姓名s.50xb性别s.20mz民族s.50sfz_hm身份证号码an.18csrq出生日期YYYY-MM-DDhjdz户籍地址s.200hyzk婚姻状况s.30syzk生育情况s.30whcd文化程度s.30返回结果样式：失败： 1 失败 无权限成功： 0 成功 张三 男汉族 1101011999101012341999-10-10 北京市海淀区中关村未婚 二胎 大学本科2.数据类型及长度说明数据类型字符含义字符型sGB 2312中的字符，包括中文字符、字母字符、数字字符等s12固定12位字符（一个字母、数字占一个字符；一个汉字占2个字符）s.12最长12个字符（一个字母、数字占一个字符；一个汉字占2个字符）s.ul长度不确定的文本a字母字符n数字字符an字母数字字符数值型I整型I12整型，最大长度为12D实型D12,2实型，总长度为12，其中小数点后2位errorMsg信息无权限xmlInput信息错误3.调用示例使用soapui工具调用相关接口服务。解压文件，获取wsdl：在soapui中新建一个soap项目，wsdl路径指向解压获取的wsdl文件路径：点击OK，生成soap项目，展开项目后找到Request1，双击打开修改Request1的URL地址，具体地址请参考第一章内容；修改报文内容，具体请参考第1.1节、第1.2节相关内容； 请求报文如下： s_1200002500000_2703 0c79353c-8278-402a-9206-a864f4e85288df-159 1551176393263 HbhPqwWzAh/uksPCutXDHExb2rPhTkUOtH/hyqmD2gk