安徽省普通高考报名考生数据接口调用说明

安徽省普通高考报名考生数据接口调用说明

为了减轻招生院校数据采集工作量，确保考生报名基础数据一致性，结合当前省考试院普通高考考生信息采集系统的实际情况，决定在2015年应用型本科院校对口招生和省属高职院校自主招生中启用数据接口服务，为招生院校提供考生报名基础数据查询服务。

一、系统设计

①、发送请求③、信息验证

①、发送请求：客户端按照一定格式要求生成字符串(含客户端认证信息和MD5校验位)；

②、信息传递：客户端将含有认证信息和MD5校验信息的字符串提交指定的服务器端URL地址；

③、信息验证：服务器端使用密钥对字符串和MD5校验位进行信息验证；

④、验证成功，请求提交：信息验证成功，在服务器端提交将数据记入数据库申请；

⑤、验证失败：返回客户端验证失败代码；

⑥、数据获取：按提交申请，获取数据；

⑦、数据返回：按照固定格式生成返回字符串，提交系统指定客户端URL地址。

为便于功能扩展和维护，系统采用浏览器/Web服务器/数据库服务器模式进行构建。

二、调用说明

1. 调用地址

URL地址：http://wendang.chazidian.com/api.html

2. 参数及传递办法

注：“3x”：代表考生真实身份证号；“XX”：代表考生真实姓名，如果姓名中存在冷僻字，冷僻字用全拼大写字母代替。

3. 返回结果

Json格式。例：{"status":"1000001","result":{"ksh":"x","xm":"a"，……}}

内容需要下载文档才能查看 内容需要下载文档才能查看

4. 错误代码

5. 示例代码（以Java为例） （1）发送请求

参数：UID，postVersion，postData，postTime，signData，merCert UID：用户名；

postVersion：功能号，”1.0.0.1”为查询考生基本信息。

postData：需要查询的考生的身份证号和姓名用json格式封装；做BASE64编码。

例如"{\"sfzh\":\"34xxxx19xxxxxx0001\",\"xm\":\"张三\"}";

postTime：当前查询时间，格式yyyymmddhh24miss。

例如(new SimpleDateFormat("yyyyMMddHHmmss")).format(new Date())。

signData：签名信息，对postData进行AES加密后做BASE64编码。 merCert：认证信息，对uuid+postTime进行md5加密。

注：ukey为公钥，uuid为认证码，由安徽省教育招生考试院生成和发放。

发送时将参数拼串发送，例：

postData=”UID=uid&postVersion=1.0.0.1&postData=BASE64.encrypt({\"sfzh\":\"34xxxx19xxxxxx0001\",\"xm\":\"张三\"})&postTime=(new SimpleDateFormat("yyyyMMddHHmmss")).format(new Date())&signData= BASE64.encrypt(AES.encrypt(postData,ukey))&merCert=md5.encrypt(uuid+postTime)”；

程序示例：

<form action="api.html" method="post">

UID:<input type="text" name="UID" value="ADMINTEST" /><br />

postVersion:<input type="text" name="postVersion" value="1.0.0.1" /><br />

postData:<input type="text" name="postData" value="xxx" /><br /> postTime:<input type="text" name="postTime" value="xxx" /><br /> signData:<input type="text" name="signData" value="xxx"/><br /> merCert:<input type="text" name="merCert" value="xxx"/><br /> <input type="submit" value="提交" />

</form>

（2）接收返回值

接口的返回值为json格式， 解析出的字符串包含两部分：状态和数据。

以”1.0.0.1”为例：

String url=“ ”;

String

param=”UID=uid&postVersion=1.0.0.1&postData=BASE64.encrypt({\"sfzh\":\"34xxxx19xxxxxx0001\",\"xm\":\"张三\"})&postTime=(new SimpleDateFormat("yyyyMMddHHmmss")).format(new Date())&signData= BASE64.encrypt(AES.encrypt(postData,ukey))&merCert=md5.encrypt(uuid+postTime)”； String result=getAhdata(URL,param);

if (!result.equals("error")){ //判断连接情况

JSONObject dataJson=JSONObject.fromObject(result);

result=dataJson.getString("status");

if (result.equals(“1000001”)){ //判断考生是否存在

JSONObject Json=listJson.getJSONObject(dataJson.getString(result)); //解析考生数据 Json.getString("KSH"); //考生号

Json.getString("XM"); //姓名

Json.getString("SFZH"); //身份证号

Json.getString("XBDM"); //性别

Json.getString("CSNY"); //出生年月

Json.getString("ZZMMDM"); //政治面貌

Json.getString("MZDM"); //民族

Json.getString("KLDM"); //科类

Json.getString("BYLBDM"); //毕业类别

Json.getString("KSLBDM"); //考生类别

Json.getString("WYYZDM"); //外语语种

Json.getString("KSLXDM"); //考生类型

Json.getString("ZXMC"); //中学名称

Json.getString("JTDZ"); //家庭地址

Json.getString("YZBM"); //邮政编码

Json.getString("JTDH"); //家庭电话

Json.getString("LXDH"); //联系电话

}

}else{

//连接异常；

}

getAhdata代码如下：

private static String getAhdata(String url, String params) {

String result="";

StringBuffer responseMessage = null;

http://wendang.chazidian.com.URLConnection connection = null;

http://wendang.chazidian.com.URL reqUrl = null;

OutputStreamWriter reqOut = null;

InputStream in = null;

BufferedReader br = null;

try {

responseMessage = new StringBuffer();

reqUrl = new http://wendang.chazidian.com.URL(url);

connection = reqUrl.openConnection();

connection.setDoOutput(true);

reqOut = new OutputStreamWriter(connection.getOutputStream()); reqOut.write(params);

reqOut.flush();

int charCount = -1;

in = connection.getInputStream();

br = new BufferedReader(new InputStreamReader(in, "Utf-8")); while ((charCount = br.read()) != -1) {

responseMessage.append((char) charCount);

}

result=responseMessage.toString();

} catch (Exception ex) {

result="error";

} finally {

try {

in.close();