云南省道路运输从业人员继续教育.docx
《云南省道路运输从业人员继续教育.docx》由会员分享，可在线阅读，更多相关《云南省道路运输从业人员继续教育.docx（13页珍藏版）》请在冰豆网上搜索。
云南省道路运输从业人员继续教育
云南省道路运输从业人员继续教育
综合管理系统与培训网站
数据交换WebServices接口的说明（试行）
云南省道路运输管理局
2016年7月
1.接口说明
1、以下拟出的数据交互接口、参数和返回值，根据实际情况可进行讨论和调整。
2、本接口除非特殊说明一律使用JSON格式
3、除非特别说明，日期格式一律使用字yyyyMMdd，例如20070101
4、接口的参数“是否必填”说明，“是”：
必须提供的非空字符串；“否”：
可提供空字符代替。
2.接口范围
本接口涉及系统包括：
云南省道路运输从业人员继续教育管理信息系统（以下简称“继续教育管理平台”）、各个培训网站。
3.技术术语
本文档所涉及的术语及缩略语解释见下表：
缩略语
英文全称
中文全称
MD5
MessageDigestAlgorithmMD5
消息摘要算法
JSON
JavaScriptObjectNotation
一种轻量级的数据交换格式
4.接口方式
采用webservice方式。
5.接口规范说明
所有对接接口的远程继续教育企业必须首先通过联调测试后才能接入正式环境，联调测试地址和正式地址如下：
测试地址：
http:
//124.133.246.162:
58089/ctms2/ws/service?
wsdl
正式地址：
:
8081/ctms2/ws/service?
wsdl
5.1.继续教育管理平台服务端
5.1.1.通用消息说明
state说明：
值
说明
01
接口调用成功
02
作为参数的json对象是空的
03
参数有误
04
IP限制
05
json参数不能转换成json数组
07
许可号错误
08
密钥错误
09
方法名错误
11
作为参数的json数组是空的
12
没有相应的结果集
5.1.2.获取报名信息接口
1.用途：
通过接口可以实时获取继续教育管理平台报名的学员信息，以便从业人员登录第三方培训网站学习。
2.方法名：
gateway（StringschoolId,StringsecretKey,StringmethodName,StringidCard）
3.参数说明：
ØschoolId许可证号，必填，由接口提供方提供，请与接口方联系
ØsecretKey密钥，必填，由接口方提供
ØmethodName：
方法名，getRegInfo
ØidCard身份证号码，必填
4.返回结果：
Ø举例如下：
属性
含义
类型
是否必须
备注
state
接口调用状态
字符串
是
见5.1.1
message
中文结果信息
字符串
是
result
实际返回结果
JSON数组
是
可传多个
id
报名信息id
数值型
是
报名信息id
name
姓名
字符串
是
sex
性别
字符串
是
1：
男，2：
女
idCard
身份证号码
字符串
是
address
住址
字符串
是
area
所属行政区划
字符串
是
国标码
category
资格类别编码
字符串
是
国标码，见附件2
senNo
从业资格证号
字符串
是
beginDate
继续教育周期起
字符串
是
endDate
继续教育周期止
字符串
是
5.1.3.上传学习信息
1.用途：
通过接口可以将第三方培训网站的从业人员完成学习的相关学习信息批量上传至继续教育管理平台，以便继续教育管理平台审核学时。
a）备注：
为减少webservice通信响应时间，上传学员数量暂定为最多100个
2.方法名：
gateway（StringschoolId,StringsecretKey,StringmethodName,StringjsonStr）
3.参数说明：
ØschoolId：
许可证号
ØsecretKey：
密钥，必填，由接口方提供
ØmethodName：
方法名，studyDetail
ØjsonStr：
采用JSON格式
各JSON属性说明：
属性
含义
类型
是否必须
备注
id
报名信息id
数值型
是
调用获取报名信息接口时获取到的报名信息id
passTime
完成学时
数值型
是
学习完成后的学时
photo
照片数据
JSON数组
是
第三方培训网站产生的照片，只可传8张，不能少于8张
time
照片采集时间
字符串
是
格式形如：
yyyy-MM-ddHH:
mm:
ss
data
照片数据
字符串
是
base64格式数据，单张照片最大12K
detail
单元学习明细
JSON数组
是
遵照继续教育大纲规定的单元，单元与数组中的JSON对象一一对应
secNo
单元号
字符串
是
见附件4
beginTime
学习开始时间
字符串
是
格式形如：
yyyy-MM-ddHH:
mm:
ss
endTime
学习结束时间
字符串
是
格式形如：
yyyy-MM-ddHH:
mm:
ss
4.返回值说明：
Ø举例：
属性
含义
类型
是否必须
备注
state
接口调用状态
字符传
是
见5.1.1
message
中文结果信息
字符串
是
result
实际返回结果
JSON数组
是
可传多个
id
报名信息id
数值型
是
调用获取报名信息接口时获取到的报名信息id
success
上传学习明细是否成功
字符串
是
true成功，false失败
msg
该学员学时上传结果信息
字符串
是
5.1.4.获取学时审核结果
1.用途：
通过接口第三方培训网站可以从继续教育管理平台获取学时审核的结果
2.方法名：
gateway（StringschoolId,StringsecretKey,StringmethodName,Stringids）
3.参数说明：
ØschoolId：
许可证号
ØsecretKey：
密钥，必填，由接口方提供
ØmethodName：
方法名，getAuditRes
Øids：
调用获取报名信息接口时获取到的报名信息id以英文逗号分隔组成的字符串
4.返回值说明：
属性
含义
类型
是否必须
备注
state
接口调用状态
字符传
是
见5.1.1
message
中文结果信息
字符串
是
result
实际返回结果
JSON数组
是
可传多个
id
报名信息id
数值型
是
调用获取报名信息接口时获取到的报名信息id
audit
审核通过或驳回
字符串
是
true通过，false驳回
msg
该学员审核结果消息
字符串
是
尚未审核；审核驳回；审核通过
6.附件
附件1：
道路运输从业人员从业资格类别编码表（老版）
000经营性道路客货运输驾驶员
001道路旅客运输驾驶员
002道路货物运输驾驶员
003道路旅客、普货运输驾驶员
100道路危险货物运输从业人员
101道路危险货物运输驾驶员
102道路危险货物运输装卸管理人员
103道路危险货物运输押运人员
104道路旅客、危货运输驾驶员
105道路普货、危货运输驾驶员
106道路旅客、普货、危货运输驾驶员
300机动车驾驶培训教练员
301理论教练员
302驾驶操作教练员
303道路客货运输从业资格培训教练员
304危险货物运输从业资格培训教练员
附件2：
道路运输从业人员从业资格类别编码表（新版）
序号
行业类别
从业资格类别
汉字全称
汉字简称
数字代码
1
道路旅客运输
经营性道路旅客运输驾驶员
客运驾驶员
01001
2
道路货物运输
经营性道路货物运输驾驶员
货运驾驶员
02001
3
道路危险货物运输
道路危险货物运输驾驶员
危货驾驶员
03001
道路危险货物运输装卸管理人员
危货装卸员
03002
道路危险货物运输押运人员
危货押运员
03003
道路危险货物运输专职安全管理人员
危货安全员
03004
剧毒化学品道路运输驾驶员
剧毒品驾驶员
03005
剧毒化学品道路运输装卸管理人员
剧毒品装卸员
03006
剧毒化学品道路运输押运人员
剧毒品押运员
03007
剧毒化学品道路运输专职安全管理人员
剧毒品安全员
03008
爆炸品道路运输驾驶员
爆炸品驾驶员
03009
爆炸品道路运输装卸管理人员
爆炸品装卸员
03010
爆炸品道路运输押运人员
爆炸品押运员
03011
爆炸品道路运输专职安全管理人员
爆炸品安全员
03012
4
放射性物品道路运输
放射性物品道路运输驾驶员
放射品驾驶员
03013
放射性物品道路运输装卸管理人员
放射品装卸员
03014
放射性物品道路运输押运人员
放射品押运员
03015
放射性物品道路运输专职安全管理人员
放射品安全员
03016
6
机动车驾驶培训
理论教练员
理论教练员
05001
驾驶操作教练员
操作教练员
05002
道路客货运输从业资格培训教练员
客货教练员
05003
道路危险货物运输从业资格培训教练员
危货教练员
05005
放射性物品道路运输从业资格培训教练员
放射品教练员
05006
机动车残疾人驾驶培训教练员
残疾人教练员
05007
7
出租汽车运输
出租汽车驾驶员
出租车驾驶员
09001
10
城市公共汽电车运输
城市公共汽电车运输驾驶员
公交驾驶员
13001
11
城市轨道交通运输
城市轨道交通运输车辆驾驶员
轨道驾驶员
14001
城市轨道交通运输行车调度员
轨道调度员
14002
城市轨道交通运输行车值班员
轨道值班员
14003
附件3：
接口传送单元号与单元对照片表
单元号
单元
unit1
单元一
unit2
单元二
unit3
单元三
unit4
单元四
unit5
单元五
unit6
单元六
unit7
单元七
unit8
单元八
unit9
单元九
注：
各类别单元数量不同，视情况可进行增删，依照国家标准即可
升级会员 