驾驶证机动车查询验证WebSerivce调用编程接口说明及示例代码
1、 引言
1.1 编写目的
为全国机动车驾驶证验证查询(物流公司、银行保险、大型网站)提供统一的WebService访问入口。接口的访问需要遵循相关的格式规定,为了使其他业务系统能很好地调用提供的WebService特编写该手册。
1.2 接口功能说明
一、查询接口(提供规范)
(1)驾驶者查询(验证),如果驾驶人姓名为空,则为驾驶证查询,否则为验证,只获取基本信息。(提交必要条件:发证机关、证件类型、证件号码,可选条件驾驶人姓名)(queryDriveInfoValidate)。
(2)机动车信息验证 提交必要条件:发证机关、车辆类型、车辆号码 、验证类型(0 查询 1发动机号校验 2 所有人校验 3 车架号校验 4 车身颜色校验);可选条件:验证关键词(queryMotorInfoValidate)。
二、接口访问地址
考虑到WebService接口提供给全国各个公司的验证查询权限及安全机制的不同,分别提供不同的WebService访问接口。
对其他业务系统的接口访问地址为:
http://webservice.jtjc.cn/Service/VioOutAccess.asmx?WSDL其中域名标识Web服务器地址
2、 调用接口说明
2.1其他业务系统的接口定义说明
一、驾驶证信息查询验证接口
(1)对外公布方法名:
public XmlDocument queryDriveInfoValidate(string Pin, string Fzjg, string Zjlx, string Zjhm, string Syr)
序号 |
参数 |
参数名称 |
注释 |
1 |
调用序列号 |
Pin |
|
2 |
发证机关 |
Fzjg |
必须 |
3 |
证件类型 |
Zjlx |
必须 |
4 |
证件号码 |
Zjhm |
必须 |
5 |
驾驶人姓名 |
Syr |
可选 |
(2)返回结果封装格式:
<?xml version="1.0" encoding="utf-8" ?>
- <DriveInfo>
<Code>00</Code>
<Message>查询成功</Message>
- <Date>
<Yxq>2003年03月31日至2009年03月31日</Yxq>
<Jsnx>旧期限</Jsnx>
<Zjcx>A2E</Zjcx>
<Ljjf>0</Ljjf>
<Cfrq>未填写</Cfrq>
<Yxqz>2009年03月31日</Yxqz>
<Hzrq>2010年03月31日</Hzrq>
<Zt>正常</Zt>
<Zxtjbrq>2008年04月29日</Zxtjbrq>
<Hzjl>3</Hzjl>
<Syjl>4</Syjl>
- <Hz0>
<HZRQ>2003年01月20日</HZRQ>
<Bhzyy>自愿降级</Bhzyy>
<Yjsqx>旧证</Yjsqx>
<Yyxqz>未填写</Yyxqz>
</Hz0>
- <Hz1>
<HZRQ>2003年12月24日</HZRQ>
<Bhzyy>期满</Bhzyy>
<Yjsqx>旧证</Yjsqx>
<Yyxqz>未填写</Yyxqz>
</Hz1>
- <Hz2>
<HZRQ>2009年04月07日</HZRQ>
<Bhzyy>遗失</Bhzyy>
<Yjsqx>旧证</Yjsqx>
<Yyxqz>未填写</Yyxqz>
</Hz2>
- <Sy0>
<Syrq>2005年12月31日</Syrq>
<Ysynd>2005年12月24日</Ysynd>
</Sy0>
- <Sy1>
<Syrq>2006年12月30日</Syrq>
<Ysynd>2006年12月24日</Ysynd>
</Sy1>
- <Sy2>
<Syrq>2008年04月29日</Syrq>
<Ysynd>2007年12月24日</Ysynd>
</Sy2>
- <Sy3>
<Syrq>2009年02月18日</Syrq>
<Ysynd>2008年12月24日</Ysynd>
</Sy3>
</Date>
</DriveInfo>
(3)备注:
code:返回结果信息,00表示正常,其他值表示调用出现出错
Message:返回结果中文解析
Date:当Code为00时,返回详细结果,否则这个节点不存在。
(4)对应字段说明
序号 |
字段名 |
字段描述 |
类型 |
长度 |
备注 |
1、 |
Yxq |
有效期限 |
Varchar2 |
25 |
|
2、 |
Jsnx |
驾驶年限 |
Char |
1 |
|
3、 |
Zjcx |
准驾车型 |
Varchar2 |
8 |
|
4、 |
Ljjf |
累计积分 |
char |
3 |
|
5、 |
Cfrq |
超分日期 |
Varchar2 |
15 |
|
6、 |
Yxqz |
有效期止 |
Date |
|
Yyyy-MM-dd |
7、 |
Hzrq |
换证日期 |
Date |
|
Yyyy-MM-dd |
8、 |
Zt |
状态 |
Varchar2 |
15 |
|
9、 |
Zxtjbrq |
最新体检表提交日期 |
Date |
128 |
Yyyy-MM-dd |
10、 |
Hzjl |
换证记录 |
Varchar2 |
50 |
参见说明1 |
11、 |
Syjl |
审验记录 |
Varchar2 |
128 |
参见说明2 |
12、 |
Hz0 |
换证数据包 |
Char |
1 |
参见说明3 |
13、 |
HZRQ |
换证日期 |
Varchar2 |
2 |
|
14、 |
Bhzyy |
换证原因 |
Varchar2 |
15 |
|
15、 |
Yjsqx r |
原驾驶期限 |
Varchar2 |
128 |
|
16、 |
Yyxqz |
原有效期止 |
Varchar2 |
1 |
|
17、 |
Sy0 |
审验数据包 |
Varchar2 |
3 |
参见说明4 |
18、 |
Syrq |
审验日期 |
Date |
|
Yyyy-MM-dd |
19、 |
Ysynd |
原审验日期 |
Varchar2 |
15 |
|
(5)说明
1) 换证记录Hzjl说明,当Hzjl为0时,则hz0数据包不存在;如果Hzjl为1 则有hz0以及相应的包体;依次类推,如上例Hzjl为3,则有hz0、hz1、hz2三组包体。
2) 审验记录Syjl说明,当Syjl为0时,则Sy0数据包不存在;如果Syjl为1 则有Sy0以及相应的包体;依次类推,如上例Syjl为4,则有Sy0、Sy1、Sy2、Sy3 四组包体。
3) 换证数据包与Hzjl相对应,当Hzjl为0时,这个节点不存在。
4) 审验数据包与Syjl相对应,当Syjl为0时,这个节点不存在。
二、机动车信息查询验证接口
(1)对外公布方法名:
public XmlDocument queryMotorInfoValidate(string Pin, string Fzjg, string Hplx, string Hphm, string Type, string Keys)
序号 |
参数 |
参数名称 |
注释 |
1 |
调用序列号 |
Pin |
|
2 |
发证机关 |
Fzjg |
必填 |
3 |
号牌类型 |
Hplx |
必填 |
4 |
号牌号码 |
Hphm |
必填 |
5 |
查询类型 |
Type |
必填 |
6 |
校验关键词 |
Keys |
可选 |
说明:查询类型(0 查询 1发动机号校验 2 所有人校验 3 车架号校验 4 车身颜色校验)
(2)返回结果封装格式:
<?xml version="1.0" encoding="utf-8" ?>
- <MotorInfo>
<Code>00</Code>
<Message>查询成功</Message>
- <DATA>
<SYXZ>货运</SYXZ>
<HDFS>购买</HDFS>
<SCYS>不提供</SCYS>
<CZRQ>2002年07月31日</CZRQ>
<FZRQ>2005年04月11日</FZRQ>
<BXYYQ>2008年08月04日</BXYYQ>
<NJYXQ>2009年07月31日</NJYXQ>
<ZT>正常</ZT>
<JYXXNUM>1</JYXXNUM>
- <JYJL0>
<JJRQ>2008年06月30日</JJRQ>
<JJJG>合格</JJJG>
<JJYXQZ>2009年07月31日</JJYXQZ>
<DJRQ>2008年06月30日</DJRQ>
</JYJL0>
</DATA>
</MotorInfo>
(3)备注
code:返回结果信息,00表示正常,其他值表示调用出现出错
Message:返回结果中文解析
Date:当Code为00时,返回详细结果,否则这个节点不存在。
(4)对应字段说明
序号 |
字段名 |
字段描述 |
类型 |
长度 |
备注 |
1、 |
SYXZ |
使用性质 |
Varchar2 |
25 |
|
2、 |
HDFS |
获得方式 |
Char |
1 |
|
3、 |
SCYS |
颜色 |
Varchar2 |
8 |
|
4、 |
CZRQ |
初次领证日期 |
char |
3 |
|
5、 |
FZRQ |
发证日期 |
Varchar2 |
15 |
|
6、 |
NJYXQ |
年检有效期 |
Date |
|
Yyyy-MM-dd |
7、 |
ZT |
当前状态 |
Varchar2 |
|
|
8、 |
JYXXNUM |
检验次数 |
Varchar2 |
15 |
参见说明1 |
9、 |
JYJL0 |
检验数据包 |
Char |
12 |
参见说明2 |
10、 |
JJRQ |
检验日期 |
Varchar2 |
50 |
|
11、 |
JJJG |
检验结果 |
Varchar2 |
128 |
|
12、 |
JJYXQZ |
检验有效期止 |
Char |
1 |
|
13、 |
DJRQ |
换证日期 |
Varchar2 |
2 |
|