广东省汽车客运场站智能管理系统联网及售票接口开发指南

《广东省汽车客运场站智能管理系统联网及售票接口开发指南》由会员上传分享，免费在线阅读，更多相关内容在教育资源-天天文库。

1、从业人员继续教育数据接口开发指南广东省交通运输厅二〇一五年一月目录1概述31.1文档内容31.2阅读对象32系统结构32.1实现机制42.2身份验证43数据报文定义53.1数据文件定义53.2数据类型定义54接口规范54.1业务逻辑54.2内容定义65继续教育数据接口85.1接口说明85.2接口方法名85.3输入参数说明85.4返回参数说明105.5示例代码136附录186.1继续教育类别参数表186.2继续教育课程大纲参数表186.3系统错误编码说明2122从业人员继续教育数据接口开发指南修订记录版本修订人修订时间修订内容备注V1.0刘蔡涛2014-11-

2、27初稿1概述1.1文档内容本文档内容旨在描述接口规范的接口方式、数据格式、传送方式的内容，对于接口具体调用中的业务数据内容本开发指南文档不做描述。本文档内容包括：系统结构、接口规范定义、接口实现方法。1.2阅读对象本文档适用于接口开发人员及设计人员。2系统结构系统结构示意图如图2-1所示。21从业人员继续教育数据接口开发指南图2-1系统结构示意图说明：省运政前置机作为中心部署了WebService接口程序，网站培训系统依据接口规范向WebService接口请求数据。1.1实现机制由调用平台根据规范的要求向前置机提交有关数据，前置机根据实际业务的要求返回相应

3、的结果，如图3-1所示。图3-1接口使用模式1.2身份验证通过接口报文中Header验证节点，验证项为用户名（UserName）和密码（Password）。用户名和密码由WebService接口平台统一制订发放。21从业人员继续教育数据接口开发指南1数据报文定义1.1数据文件定义数据体文件为XML格式文件，编码方式为UTF-8。1.2数据类型定义统一通过字符串的格式传递数据,上报数据内容的格式，作为WebService的传入参数。字符串传入参数消息与输出消息由消息头和消息基本信息、消息详细内容组成消息体。如下图所示：2接口规范2.1业务逻辑l网络远程培训系统

4、经省交通运输主管部门备案通过后，由省级交通运输主管部门统一发放数据报送接口账号。l网络远程培训系统报送从业人员所属地或者备案地，与培训机构备案地一致的从业人员参与继续教育的数据。l培训周期算法：从业人员证件有效期倒推6年作为证件发证日期，若发证21从业人员继续教育数据接口开发指南日期为2011年5月1日前，周期从2011年5月1日开始计算，需要参加的教育周期数从2011年5月1日至截止日期的周期数。否则发证日期为2011年5月1日后按初领取日期开始计算。例如：证件发证日期为2009年4月1日，则需要参加的教育周期数为1个周期；若证件发证日期为2009年5月3

5、日，则需要参加的教育周期为2个周期。若证件发证日期为2011年5月1日，则需要参加的周期数为3个周期。l一次报送数据请求，所包含的数据量不能超过100条。1.1内容定义l培训周期格式：若证件发证日期在2011年5月1日前，以2011年5月1日作为培训周期开始日期；若发证日期在2011年5月1后，以次日作为培训周期的开始日期，以每两年为一个周期类推，例如：若证件发证日期为2009年4月5日，则培训周期分别为20110501-20130430。若证件发证日期为2009年6月6日，则培训周期分别20110501-20130430,20130501-20150430

6、。若证件发证日期为2011年6月6日，则培训周期分别为：20110607-20130606,20130607-20150606,20150607-20170606。l报送数据内容及格式相关要求如下表所述：节点名称数据内容数据类型是否为空说明IDID字符串否唯一字符串，GUID格式PeiXunJiGouDaiMa培训机构代码字符串否从业人员参与继续教育学习的培训机构代码PeiXunJiGouMingCheng培训机构名称字符串否从业人员参与继续教育学习的培训机构名称XiaQuShi辖区市字符串否培训机构备案所属辖区市，例如：中山、广州XiaQuXian辖区县字

7、符串是培训机构备案所属辖区县，21从业人员继续教育数据接口开发指南例如：天河、越秀XingMing姓名字符串否参与继续教育从业人员的姓名XingBie性别字符串否参与继续教育从业人员的性别，可选值：男、女ShenFenZhengHaoMa身份证号码字符串否参与继续教育从业人员的身份证号码CongYeZiGeLeiBie从业资格类别字符串否参与继续教育从业人员的从业资格类别CongYeZiGeZhengHao从业资格证号字符串否参与继续教育从业人员的从业资格证号CongYeZiGeZhengYouXiaoRiQi从业资格证有效日期字符串否参与继续教育从业人员的

8、证件有效日期，格式：yyyy-MM-ddCanYuP