📢 一、API接口传参格式调整:
自2023年12月1日凌晨0点起,市监管平台数据对接所使用的以下个API 接口参数调整。
以下接口参数不再需要进行传递
1.针对以下4个API接口所涉及的access参数和errorinfo参数不再需要传递,后续只推送活跃度检测通过跟考试通过的记录,涉及的4个API接口列表如下:
(1)社会化、学徒制等培训项目 --- 学时信息采集接口 (post4)
(2)社会化、学徒制等培训项目 --- 考试信息采集接口 (post5)
(3)企业职业线上培训项目 --- 学时信息采集接口(post4)
(4)企业职业线上培训项目 --- 考试信息采集接口(post5)
2.针对以下2个API接口中的learnTime、playTime、loginTime、chapterTime参数不再需要传递:
(1)社会化、学徒制等培训项目 --- 学时信息采集接口 (post4)
(2)企业职业线上培训项目 --- 学时信息采集接口(post4)
3.针对以下1个API接口中的areaName、trainingName、trainingCode、shortName、courseHour参数不再需要传递:
(1)企业职业线上培训项目 --- 班级基本信息采集接口(post3)
以下接口参数格式修改
4.针对以下2个API接口所涉及的chapterTime、examTime、learnHour参数,计数单位格式由“分钟”更改为“秒”进行传递:(注:所有培训过程中的数据及将要开展培训的数据均此要求调整,已经结束培训的班级可通过填报《信息修改申报单》申请调整。)
(1)企业职业线上培训项目 --- 班级基本信息采集接口(post3)
(2)社会化、学徒制等培训项目 --- 班级基本信息采集接口(post3)
📢 二、企业职工线上培训项目对接流程调整:
1.自2023年12月1日凌晨0点起,市监管平台企业职工线上培训项目获取项目编号流程更改,参照”社会化、学徒制等培训项目”的项目编号获取方式,不再进行手动绑定。自2023年12月1日凌晨0点 起,项目编号获取方式更改为:通过“企业线上培训项目-获取培训正在进行中的(项目编号)”接口来获取项目编号列表,各平台可根据获取的项目编号进行推送,且不再需要推送下游编号。自此接口调整日起,后续该接口未返回的项目编号的班级将被监管平台拒绝接收。当各平台无法通过接口获取项目编号列表时,请及时第一时间发邮件到监管平台报备,邮件内容写明未查询到的项目编号。
2.自2023年12月1日凌晨0点起,采用新的数据推送流程。
各平台未绑定项目编号的已推送班级,应在12月1日前完成项目编号绑定工作,项目编号可通过新开放的“线上企业培训项目-获取培训正在进行中的(班级编号,项目编号)列表”进行查询。或采用以前接口查询未绑定项目编号接口进行查询。
📢 三、版本更新对接测试要求和流程:
本次版本更新测试时间为:2023年11月6日至2023年12月1日结束。测试期间,有任何接口对接问题,请及时通过邮件沟通。测试期间,各平台需按照以下流程完成对接测试:
1.按照新的接口标准规范,将各平台生产环境中两个的正在培训中或已经完成培训的班级数据推送至测试环境。
2.推送完成后,需将平台名称、项目编号以邮件形式发送至上海市互联网培训监管平台公共邮箱(public_dudaoyun@163.com)进行测试核实。
3.市监管平台将配合各平台检查数据的规 范性、完整性,数据确认无误后,对接测试的核实结果将通过邮件形式反馈给各平台。测试期间,各平台技术人员请按照邮件指示内容和相关接口开发技术文档进行修改和数据进行推送。
注:各平台需积极配合参加接口测试工作,因平台自身原因没有完成测试,造成生产数据推送错误等所有问题,由各平台自行承担后果。 📢 四、接口开发技术文档“开发前必读-采集要求”增加注释内容:
1.活跃度检测照片与实名认证照片不可在同次进行照片采集。
2.活跃度检测照片推送时间不可超过做过活跃度检测生产日期的72小时以上。
3.学员的学时信息应在实名认证照片上传的后再进行推送。
4.答疑辅导数据应在培训期间内进行推送。
5.当日产生的数据,次日24小时内应全部推送至监管平台。如遇特殊情况,推送数据延迟不得超过数据生产日期的72小时以上,过期数据将不被接收。每次延迟推送行为都将被累计记录,以作为监管平台风控报警的依据。