DOC《广州市机动车驾驶员计时培训系统技术规范和广州市学驾平台...》

b) 局域网网络交换速度不低于100Mbps. (规范性附录) 数据交换HTTP接口协议 数据格式及约束条件 数据格式见JT/T 697.1―2013中5.15. 所有的请求和应答报文均采用JSON格式. 约束条件见表A.1. 约束条件 符号 约束条件 ? 0..1,可选项 * 0..n,可以没有,也可以有多项 + 1..n,至少有1项,也可以有多项

1 必须且只能填1项F固定长度 V 可变长度 接口通用应答 接口通用应答 字段名称 层级 类型 取值 默认值 意义 备注 errorcode 1.1 int 详见附录A.3错误码定义

0 错误码 message 1.2 string null 提示信息 data 1.3 object null 附加信息 错误码定义 错误码定义 错误码 意义 备注

0 执行成功/数据上传成功

1 执行失败

100 请求的服务/资源不存在

200 数据格式错误,无法正确解析 统一编号规则 学时记录编号:XXXXXX(行政代码)XXXX(运营商序列号)XXXXXX(计时设备序列号)XXXXXX(年月日YYMMDD)XXXX(自增流水号) 课程编码:X(阶段:

1、

2、3)X(实操1,理论集中学习2,模拟3,远程教学4)XX(一级课程)XX(二级课程)XX(三级课程)XX(四级课程) 文件资料信息接口 业务描述:资料文件上传,支持JPG/JPEG、PNG、PDF等不同类型的文件.不同的接口需要上传的信息中含有多媒体、PDF等资料文件时,应先使用本接口上传资料文件,从应答中获得文件的ID,然后再使用相应的业务数据接口并将获得的文件ID和其他信息一起上传. 接口定义见表A.4: 文件资料信息上传接口定义 服务名 Imageup URL /imageup/{type}? v={version}&

ts={timestamp}&

sign={sign_str}&

user={cert_sn} HTTP方法 POST 参数/表域 Type:文件业务类型 { stuimg:学员头像;

stufp:学员指纹;

coachimg:教练员头像;

coachfp:教练员指纹;

examinerimg:考核员头像;

examinerfp:考核员指纹;

securityguardimg:安全员头像;

securityguardfg:安全员指纹;

vehimg:教练车图片;

outletsimg:招生点照片;

occupationimg:资格证书图片;

voiceprintimg:声纹文件;

epdfimg:电子培训部分记录表PDF文件;

onlineimg:网络远程学习过程照片;

classroom:课堂教学过程照片;

simulation:模拟教学过程照片;

video:视频文件 } 备注 应答报文格式见表A.5: 文件资料信息上传应答报文格式 序号 元素名称 必选 类型 长度 字段名称 描述及要求

1 errorcode 是 数值型 V16 返回码

2 message 是 字符型 V128 提示信息

3 data 是 对象 附加信息

4 id 是 数值型 V16 成功上传的文件ID 平台间数据传输接口 培训机构信息 培训机构信息接口 备案培训机构接口 业务描述:用于计时平台向广州市学驾服务平台备案培训机构信息. 接口定义见表A.6: 备案培训机构接口定义 服务名 Institution URL /institution? v={version}&

ts={timestamp}&

sign={sign_str}&

user={cert_sn} HTTP方法 POST 参数/表域 备注 请求报文格式见表A.7: 备案培训机构请求报文格式 序号 元素名称 必选 类型 长度 字段名称 描述及要求

1 district 是 字符型 F6 区县行政区划代码 见GB/T

2260 2 name 是 字符型 V256 培训机构名称 填写名称全称

3 shortname 是 字符型 V128 培训机构简称 填写简称

4 licnum 是 字符型 F12 经营许可证编号

5 licetime 是 字符型 V64 经营许可日期 YYYYMMDD

6 business 是 字符型 F20 营业执照注册号

7 creditcode 否 字符型 F18 统一社会信用代码

8 address 是 字符型 V512 培训机构地址