云南省道路运输从业人员继续教育

云南省道路运输从业人员继续教育

综合管理系统与培训网站

数据交换Web Services接口的说明（试行）

云南省道路运输管理局

2016年7月

目录

1.接口说明 (3)

2.接口范围 (3)

3.技术术语 (3)

4.接口方式 (3)

5.接口规范说明 (4)

5.1.继续教育管理平台服务端 (4)

5.1.1.通用消息说明 (4)

5.1.2.获取报名信息接口 (4)

5.1.3.上传学习信息 (6)

5.1.4.获取学时审核结果 (8)

6.附件 (9)

1.接口说明

1、以下拟出的数据交互接口、参数和返回值，根据实际情况可进行讨论和调整。

2、本接口除非特殊说明一律使用JSON格式

3、除非特别说明，日期格式一律使用字yyyyMMdd，例如20070101

4、接口的参数“是否必填”说明，“是”：必须提供的非空字符串；“否”：可提供

空字符代替。

2.接口范围

本接口涉及系统包括：云南省道路运输从业人员继续教育管理信息系统(以下简称“继续教育管理平台”)、各个培训网站。

3.技术术语

本文档所涉及的术语及缩略语解释见下表：

4.接口方式

采用webservice方式。

5.接口规范说明

所有对接接口的远程继续教育企业必须首先通过联调测试后才能接入正式环境，联调测试地址和正式地址如下：

测试地址：http://124.133.246.162:58089/ctms2/ws/service?wsdl

正式地址：:8081/ctms2/ws/service?wsdl 5.1.继续教育管理平台服务端

5.1.1.通用消息说明

state说明：

5.1.2.获取报名信息接口

1.用途：通过接口可以实时获取继续教育管理平台报名的学员信息，以便从业人员登

录第三方培训网站学习。

2.方法名：gateway (String schoolId, String secretKey,String methodName,

String idCard)

3.参数说明：

➢schoolId 许可证号，必填，由接口提供方提供，请与接口方联系

➢secretKey 密钥，必填，由接口方提供

➢methodName：方法名，getRegInfo

➢idCard 身份证号码，必填

4.返回结果：

➢举例如下：

属性含义类型是否必须备注

state 接口调用状态字符串是见5.1.1

message 中文结果信息字符串是

result 实际返回结果JSON数组是可传多个id 报名信息id 数值型是报名信息id

name 姓名字符串是

sex 性别字符串是1：男，2：女

5.1.3.上传学习信息

1.用途：通过接口可以将第三方培训网站的从业人员完成学习的相关学习信息批量

上传至继续教育管理平台，以便继续教育管理平台审核学时。

a)备注：为减少webservice通信响应时间，上传学员数量暂定为最多100个

2.方法名：gateway (String schoolId, String secretKey, String

methodName,String jsonStr)

3.参数说明：

➢schoolId：许可证号

➢secretKey：密钥，必填，由接口方提供

➢methodName：方法名，studyDetail

➢jsonStr：采用JSON格式

各JSON属性说明：

属性含义类型是否必

须

备注

id 报名信息id 数值型是调用获取报名信息接口时获取到

的报名信息id

passTime 完成学时数值型是学习完成后的学时

photo 照片数据JSON数组是第三方培训网站产生的照片，只可传8张，不能少于8张

time 照片采集时间字符串是格式形如：yyyy-MM-dd HH:mm:ss

data 照片数据字符串是base64格式数据，单张照片最大

12K

detail 单元学习明细JSON数组是遵照继续教育大纲规定的单元，单元与数组中的JSON对象一一对

应

secNo 单元号字符串是见附件4 beginTime 学习开始时间字符串是格式形如：yyyy-MM-dd HH:mm:ss endTime 学习结束时间字符串是格式形如：yyyy-MM-dd HH:mm:ss 4.返回值说明：

➢举例：

属性含义类型是否必须备注

state 接口调用状态字符传是见5.1.1

message 中文结果信息字符串是

result实际返回结果JSON数组是可传多个

id 报名信息id 数值型是调用获取报名信息接口时获取到的报名信息id

success 上传学习明细是否

成功

字符串是true成功，false失败

msg 该学员学时上传结

果信息

字符串是

5.1.4.获取学时审核结果

1.用途：通过接口第三方培训网站可以从继续教育管理平台获取学时审核的结果

2.方法名：gateway (String schoolId, String secretKey, String

methodName,String ids)

3.参数说明：

➢schoolId：许可证号

➢secretKey：密钥，必填，由接口方提供

➢methodName：方法名，getAuditRes

➢ids：调用获取报名信息接口时获取到的报名信息id以英文逗号分隔组成的字符串

4.返回值说明：

属性含义类型是否必须备注