V3.0.0

2023-11-06

📢 一、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小时以上，过期数据将不被接收。每次延迟推送行为都将被累计记录，以作为监管平台风控报警的依据。

V2.1.1

2023-05-06

⚡️ API接口传参格式调整：自2023年5月10日（星期三） 凌晨0点起，市监管平台数据对接所使用的以下6个API 接口格式由调整formdata传参更改为JSON传参:（1）社会化、学徒制等培训项目 --- 获取培训正在进行中的（班级编号，项目编号）列表 （2）社会化、学徒制等培训项目 --- 获取推送失败班级列表 （3）社会化、学徒制等培训项目 --- 清除推送失败班级缓存 （4）企业职业线上培训项目 --- 获取推送失败班级列表 （5）企业职业线上培训项目 --- 清除推送失败班级缓存 （6）企业职业线上培训项目 --- 企业线上培训项目-获取培训待绑定的（班级编号，项目编号）列表

V2.1.0

2023-03-29

📢 市监管平台“社会化、学徒制等培训项目”、“企业职业线上培训项目”数据对接 API 接口中学时信息采集信息接口增加注释：（1）“社会化、学徒制等培训项目-班级行为信息-学时信息采集接口”中"章节（课程）学习时长”字段注释补充描述更改为：该学习时间段内本章节学习累计时长【秒】（不包含暂停时长）。（2）“企业线上培训项目-班级行为信息-学时信息采集接口”中"章节（课程）学习时长”字段注释补充描述更改为：该学习时间段内本章节学习累计时长【秒】（不包含暂停时长）。

V2.0.0

2023-01-16

📢 市监管平台“社会化、学徒制等培训项目”、“企业职业线上培训项目”数据对接 API 接口要求更新（2月1日后的数据实行）：（1）调整计时单位：“班级行为信息-考试信息采集接口”中"章节（课程）考试总时长”字段计时单位“分”，修改为“秒”。（2）调整计时单位：“班级行为信息-学时信息采集接口”中"当日累积学习时长"、"当日累积登录时长"、"当日累积播放时长"、及该学习时间段内"章节（课程）学习时长"四个字段计时单位“分”，修改为“秒”。（3）增加接口字段：“班级行为信息-学时信息采集接口”中"章节（课程）学时列表"下新增"章节（课程）累计暂停时长"字段。（4）接口字段更名：“班级行为信息-学时信息采集接口”中"章节（课程）学时列表"下"章节（课程）学习时长"更名为"章节（课程）累计学习时长"字段。（5）增加字段注释：“班级行为信息-学时信息采集接口”中"章节（课程）学时列表"下"学习开始时间"和"学习结束时间"增加注释：学习开始时间等同于视频播放开始时间，学习结束时间等同于视频播放结束时间。（6）调整注释：调整活跃度检测规则注释：当天每累计播放45分钟需进行至少一次活跃度检测；暂停时间不计入累计播放时长内；如用户登出系统则中断累计45分钟计时；如活跃度检测未通过，则本次学习时长无效。（7）调整注释：“开发前必读”中“采集要求”调整注释：每连续学习45分钟至少进行一次活跃度检测。注：单条视频累计播放时长大于45分钟或多条视频累计播放时长大于45分钟均视为连续学习大于45分钟，需完成至少一次活跃度检测；暂停时间不计入累计播放时长内；如用户登出系统则中断累计45分钟计时；如活跃度检测未通过，则本次学习时长无效。

V1.1.3

2022-10-24

⚡️ 答疑辅导字段名anwser改为answer

V1.1.2

2022-10-24

🔥 原基本信息采集中的anwserLisit集合变更为独立的接口，用来采集 "答疑辅导" 记录中的 "提问时间" 和 "回答时间"。其中，只有 "提问时间" 和 "回答时间" 都存在时才做传递，只有 "提问时间" 没有 "回答时间" 不做传递 。

V1.1.1

2022-10-22

🔥 基础信息采集中新增anwserList集合，用来采集 "答疑辅导" 记录中的 "提问时间" 和 "回答时间"。其中，只有 "提问时间" 和 "回答时间" 都存在时才做传递，只有 "提问时间" 没有 "回答时间" 不做传递 。

V1.1.0#

2022-08-22

📢 对社会化照片采集频率限制进行更新

V1.0.0

2022-08-19

🔥 新功能

⚡️ 优化

🐞 BUG修复

📢 通知