福建省补贴性职业培训管理平台接口文档

用于接收线上培训平台学习成果，提供属地人社审核培训过程的数据，系统自动根据上报的学习成果数据与监管平台的数据进行比对核验，未按要求接受监管的课程学时将无法记入培训学时。

福建省补贴性职业培训管理平台：https://zypx.fjrst.cn/

监管平台接口文档请查看

接口使用范围

仅适用接入监管平台的线上培训平台。

使用流程

• 1、申请接入（与监管平台使用相同的授权）
• 2、技术对接
• 3、测试上线

补贴管理平台API接口

测试环境域名：https://opentestv1.fjrst.cn

正式环境域名：https://open.fjrst.cn

1、获取token

每个学员每个时刻确保只能在一个平台上学习一个课程，如果存在已学习的课程，无法获取Token。

请求URL： /v1/token

请求方式： POST

请求参数：

响应结果：

请求示例：

{
  "appId": "eb7200f7fc45460d96507c4fa03b3934",
  "appSecret": "xxxxxxxx完成申请流程后可查看",
  "idCard": "3501241980xxxxx"
}

响应示例：

{
  "code": 0,
  "msg": "操作成功",
  "data": {
    "access_token": "eb7200f7fc45460d96507c4fa03b3934"
  }
}

异常响应示例：

{
  "code": 401,
  "msg": "当前人员已在其他平台开始学习",
  "data": {
    "name": "xxxx培训平台",
    "startTime": "2021-03-17 12:22:32"
  }
}

2、按工种上传课程数据

用于申请机构填报培训方案时选择线上课程。 使用工种名称进行课程包匹配，课程包下的课程将作为培训方案的线上课程部分显示。

请求URL： /v1/upCoursePackage

请求方式：POST

请求参数:

courses 对象说明:

supply 对象说明:

响应结果：

请求示例：

{
  "token": "20604980-3079-11ec-a40d-f596dd76cca1",
  "job": "工种",
  "packageId": "课程包ID",
  "packageName": "课程包名称",
  "coverImg": "封面图地址",
  "times": 36000,
  "status": 1,
  "courses": [
    {
      "courseId": "课程ID",
      "courseType": "理论课程",
      "courseUrl": "https://",
      "name": "外链的电影课程",
      "teacher": "张三，李四",
      "times": 36000
    }
  ],
  "supply": {
    "addr": "联系地址",
    "linkman": "联系人",
    "mobile": "联系电话",
    "name": "内容提供商名称"
  }
}

响应示例：

成功响应

{
  "code": 0
}

3、获取上传课程数据

用于申请机构填报培训方案时选择线上课程。

请求URL： /v1/getCoursePackage

请求方式：GET

请求参数:

响应结果：

请求示例：

{
    "token":"20604980-3079-11ec-a40d-f596dd76cca1",
    "job":"电工",
    "page":1,
    "size":20
}

响应示例：

成功响应

{
    "code": 0,
    "msg": "操作成功",
    "count": 1,
    "data": [
        {
            "id": "7ffe9100-3d15-11ec-884a-37bf96fe99fb",
            "packageId": "课程包ID",
            "appId": "fjhb",
            "packageName": "课程包名称",
            "job": "工种",
            "times": 36000,
            "total": "0",
            "coverImg": "封面图地址",
            "status": 1,
            "supply": {
                "addr": "联系地址",
                "name": "内容提供商名称",
                "mobile": "联系电话",
                "linkman": "联系人"
            },
            "courses": [
                {
                    "courseId":"课程ID",
                    "name": "外链的电影课程",
                    "times": 36000,
                    "teacher": "隋准，隋准",
                    "courseUrl": "https://",
                    "courseType": "理论课程"
                }
            ],
            "is_del": 0,
            "createdAt": "2021-11-04T02:18:28.000Z",
            "updatedAt": "2021-11-04T02:18:28.000Z"
        }
    ]
}

4、上报学员学习成果

用于培训平台上报线上课程学习结果，补贴管理平台将会对上报的学习结果进行验证（监管平台收集的数据），未通过监管平台比对的学习结果将无法记入培训学时。

请求URL： /v1/upTrainResult

请求方式：POST

请求参数:

result对象说明：

logs对象参数说明：

响应结果：

请求示例：

{
  "token": "20604980-3079-11ec-a40d-f596dd76cca1",
  "packageId": "packageId",
  "idCard": "350103198xxxxxxx",
  "prove": "http://xx.com/xx.pdf",
  "result": [{
    "courseId": "591course",
    "startTime": "2021-09-19T01:38:31.959Z",
    "endTime": "2021-10-19T01:38:31.959Z",
    "courseTimes": 3200,
    "studyTimes": 3600,
    "studyIP": "202.210.105.x",
    "studyCount": 2
  }]
}

响应示例：

成功响应

{
  "code": 0
}

5、获取学员学习成果

用于获取学员的学习成果比对结果，方便培训平台进行核对。

请求URL： /v1/getTrainResult

请求方式：GET

请求参数:

响应结果：

请求示例：

响应示例：

成功响应

{
  "code": 0,
  "data": [
    {
      "id": "",
      "packageId":"",
      "appId": "",
      "idCard": "",
      "status": 0,
      "remark": "",
      "result": [{
          "courseId":"",
          "endTime": "2021-10-19T01:38:31.959Z",
          "studyIP": "127.0.0.1",
          "startTime": "2021-09-19T01:38:31.959Z",
          "studyCount": 2,
          "status": 0,
          "hasTimes_s":3600,
          "studyTimes": 3600,
          "courseTimes": 3200
      }],
      "createdAt": "2021-03-10 19:45:22",
      "updatedAt": "2021-03-10 19:45:22"
    }
  ]
}

响应结果data内obj对象说明：