昶戈开放平台
  1. 学员培训数据
昶戈开放平台
  • 昶戈开放平台
    • 概述
    • 对接步骤
    • 开始开发
      • 获取企业授权
    • 通讯录管理
      • 岗位管理
        • 批量添加岗位
        • 删除岗位
        • 获取岗位列表
        • 增加/修改岗位信息
        • 批量删除岗位成员数据
        • 增加岗位成员数据
      • 成员管理
        • 批量增加修改用户信息
        • 批量删除用户
        • 批量启用用户
        • 批量停用用户
        • 获取用户列表
        • 增加修改用户信息
        • 获取显示企业用户自定义字段列表 *
      • 产品线管理
        • 删除产品线
        • 获取产品线列表
        • 增加修改产品线人员信息
        • 增加修改产品线信息
      • 标签管理
        • 删除标签
        • 获取标签列表
        • 增加修改标签信息
        • 批量删除标签成员数据
        • 获取标签成员数据
        • 增加标签成员数据
      • 部门管理
        • 批量添加/修改部门
        • 批量添加部门(树形结构添加)
        • 删除部门
        • 获取部门列表
        • 增加修改部门信息
    • 授权登录
      • 免登录URL
    • 合作商开放接口
      • 企业配置
        • 获取合作商授权 *
        • 删除企业信息 *
        • 获取企业列表 *
        • 增加/修改企业信息 *
    • 消息和事件通知
      • 消息和事件通知
        • 订阅 *
        • 取消订阅 *
      • 消息和事件通知接收消息
        • 接收消息推送
    • 培训数据
      • 课程
        • 获取PC端首页第一个推荐课程
        • 获取移动端首页第一个推荐课程 *
      • 学员培训数据
        • 获取学员培训项目数据
          POST
        • 获取学员培训项目数据 V2
          POST
      • 实验室课程
        • 获取课程人员基础信息接口
        • 实验数据上传接口
    • 附录
      • 加密及算法
  1. 学员培训数据

获取学员培训项目数据 V2

测试环境
https://api.test.tgtrain.cn
测试环境
https://api.test.tgtrain.cn
POST
/partner/taskmember/list/v2
/partner/taskmember/list获取任务学员学习数据

请求参数

Query 参数
access_token
string 
企业密钥
必需
示例值:
myzdk0zcoyDdXgi6DeQvMInzbD65W7mcyofADnOS2xMyLKzXu95xNYBMJEJbLGe3Bv6W2dKV8sJxONPgnBC4gfVxeCEBnTmxcWKZ2LwX8OsUASALTBLlWa2OXcsVLnmmFHNSy8G8oo00oUBHRsQn6Imcoo00oZYjorM1b41GVznacMGuQPbh7poFci81q1xhTQm7Xo3m
Body 参数application/json
page
integer 
页码
必需
pageSize
integer 
每页数
必需
complete
integer 
完成状态
可选
1已完成 2未完成
根据1查询已完成的专题项目地图新人培训和已通过的考试,根据2查询有权但是未完成的专题项目地图新人培训和不通过未参与待批阅的考试
keyword
string 
姓名/账号/手机号
可选
accounts
array[string]
多账号查询
可选
realname
string 
真实姓名
可选
(学习平台显示名称)
mobile
string 
手机号
可选
tasktype
integer 
任务类型
必需
1培训项目 5专题培训 6学习地图 9新员工培训 10考试任务
taskDepartmentIds
array[integer]
任务所属部门ID列表
可选
(可通过部门列表接口获得)/(与taskDepartmentCodes二选一传递)
taskDepartmentCodes
array[string]
任务所属部门编号
可选
(同步对接的CODE)列表 /(与taskDepartmentIds二选一传递)
taskName
array[string]
任务名称
可选
(支持模糊查询)
completeTime
array[string]
完成时间起-完成时间止
必需
(时间格式:2006-01-02 15:04:05)
示例
{
    "page": 1,
    "pageSize": 30,
    "complete": 1,
    "keyword": "",
    "accounts": [
        "00123021",
        "12004525"
    ],
    "realname": "张三",
    "mobile": "",
    "tasktype": 1,
    "taskDepartmentIds": [
        14,
        58,
        10
    ],
    "taskDepartmentCodes": [
        "1-00-100-71"
    ],
    "taskName": [
        "培训班集中培训",
        "集中考试"
    ],
    "completeTime": [
        "2025-01-16 19:16:31",
        "2025-01-08 09:17:40"
    ]
}

示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.test.tgtrain.cn/partner/taskmember/list/v2?access_token=myzdk0zcoyDdXgi6DeQvMInzbD65W7mcyofADnOS2xMyLKzXu95xNYBMJEJbLGe3Bv6W2dKV8sJxONPgnBC4gfVxeCEBnTmxcWKZ2LwX8OsUASALTBLlWa2OXcsVLnmmFHNSy8G8oo00oUBHRsQn6Imcoo00oZYjorM1b41GVznacMGuQPbh7poFci81q1xhTQm7Xo3m' \
--header 'Content-Type: application/json' \
--data-raw '{
    "page": 1,
    "pageSize": 30,
    "complete": 1,
    "keyword": "",
    "accounts": [
        "00123021",
        "12004525"
    ],
    "realname": "张三",
    "mobile": "",
    "tasktype": 1,
    "taskDepartmentIds": [
        14,
        58,
        10
    ],
    "taskDepartmentCodes": [
        "1-00-100-71"
    ],
    "taskName": [
        "培训班集中培训",
        "集中考试"
    ],
    "completeTime": [
        "2025-01-16 19:16:31",
        "2025-01-08 09:17:40"
    ]
}'

返回响应

🟢200成功
application/json
Body
ret
integer 
接口状态
必需
data
object 
数据
必需
list
array [object {61}] 
集合
必需
page
integer 
当前页
必需
pageSize
integer 
每页数
必需
totals
integer 
总数
必需
示例
{
    "ret": 0,
    "data": {
        "list": [
            {
                "userId": 0,
                "account": "string",
                "realName": "string",
                "nickName": "string",
                "birthday": 0,
                "departmentId": 0,
                "departmentName": "string",
                "department": "string",
                "departmentCode": "string",
                "positionId": 0,
                "position": "string",
                "positionRank": "string",
                "country": "string",
                "province": "string",
                "city": "string",
                "district": "string",
                "email": "string",
                "portrait": "string",
                "expireDate": 0,
                "entryDate": 0,
                "address": "string",
                "number": "string",
                "identityId": "string",
                "mobile": "string",
                "tel": "string",
                "remarks": "string",
                "directorId": 0,
                "director": "string",
                "directorAccount": "string",
                "createUid": 0,
                "createUser": "string",
                "createTime": 0,
                "platforms": "string",
                "gender": 0,
                "userType": 0,
                "activate": 0,
                "identityType": 0,
                "labelIds": null,
                "labelNames": null,
                "status": 0,
                "distributeaccount": "string",
                "joinTime": 0,
                "memberActivate": "string",
                "startTime": 0,
                "complete": 0,
                "endTime": 0,
                "completeTime": 0,
                "firstTime": 0,
                "lastTime": 0,
                "learnTime": 0,
                "exams": 0,
                "examTime": 0,
                "progress": 0,
                "studyDetails": [
                    {
                        "customerId": 0,
                        "taskId": 0,
                        "detailId": 26775,
                        "userId": 315556,
                        "startTime": 1747734205,
                        "completeTime": 1747734346,
                        "progress": 100,
                        "courseSectionProgress": 0,
                        "courseCompleteStatus": 0,
                        "resourceType": 2,
                        "complete1": 1,
                        "qualifier": 1,
                        "resourceId": 42669,
                        "lastTime": 1747734346,
                        "learnTime": 75,
                        "learnLocation": 0,
                        "examTime": 0,
                        "studyIntegral": 0,
                        "studyScore": 0,
                        "examScore": 0,
                        "studyTime": 0,
                        "completeFromSync": 0,
                        "completeFromAdmin": 0,
                        "syncTime": 0,
                        "batch": 0,
                        "progressTwoDigitStr": "",
                        "aiSparringScore": 0,
                        "aiSparringStatus": 0
                    },
                    {
                        "customerId": 0,
                        "taskId": 0,
                        "detailId": 26776,
                        "userId": 315556,
                        "startTime": 1747734392,
                        "completeTime": 1747734428,
                        "progress": 100,
                        "courseSectionProgress": 0,
                        "courseCompleteStatus": 0,
                        "resourceType": 3,
                        "complete1": 1,
                        "qualifier": 1,
                        "resourceId": 1288,
                        "lastTime": 1747734392,
                        "learnTime": 65,
                        "learnLocation": 0,
                        "examTime": 65,
                        "studyIntegral": 0,
                        "studyScore": 0,
                        "examScore": 80,
                        "studyTime": 0,
                        "completeFromSync": 0,
                        "completeFromAdmin": 0,
                        "syncTime": 0,
                        "batch": 0,
                        "progressTwoDigitStr": "",
                        "aiSparringScore": 0,
                        "aiSparringStatus": 0
                    },
                    {
                        "customerId": 0,
                        "taskId": 0,
                        "detailId": 26777,
                        "userId": 315556,
                        "startTime": 1747734460,
                        "completeTime": 1747734534,
                        "progress": 100,
                        "courseSectionProgress": 0,
                        "courseCompleteStatus": 0,
                        "resourceType": 1,
                        "complete1": 1,
                        "qualifier": 1,
                        "resourceId": 52103,
                        "lastTime": 1747734537,
                        "learnTime": 63,
                        "learnLocation": 0,
                        "examTime": 0,
                        "studyIntegral": 0,
                        "studyScore": 0,
                        "examScore": 0,
                        "studyTime": 0,
                        "completeFromSync": 0,
                        "completeFromAdmin": 0,
                        "syncTime": 0,
                        "batch": 0,
                        "progressTwoDigitStr": "",
                        "aiSparringScore": 0,
                        "aiSparringStatus": 0
                    },
                    {
                        "customerId": 0,
                        "taskId": 0,
                        "detailId": 26778,
                        "userId": 315556,
                        "startTime": 1747734446,
                        "completeTime": 1747734446,
                        "progress": 100,
                        "courseSectionProgress": 0,
                        "courseCompleteStatus": 0,
                        "resourceType": 39,
                        "complete1": 1,
                        "qualifier": 1,
                        "resourceId": 644,
                        "lastTime": 1747734446,
                        "learnTime": 0,
                        "learnLocation": 0,
                        "examTime": 0,
                        "studyIntegral": 0,
                        "studyScore": 0,
                        "examScore": 0,
                        "studyTime": 0,
                        "completeFromSync": 0,
                        "completeFromAdmin": 0,
                        "syncTime": 0,
                        "batch": 0,
                        "progressTwoDigitStr": "",
                        "aiSparringScore": 0,
                        "aiSparringStatus": 0
                    },
                    {
                        "customerId": 0,
                        "taskId": 0,
                        "detailId": 26779,
                        "userId": 315556,
                        "startTime": 1747734458,
                        "completeTime": 1747734458,
                        "progress": 100,
                        "courseSectionProgress": 0,
                        "courseCompleteStatus": 0,
                        "resourceType": 5,
                        "complete1": 1,
                        "qualifier": 1,
                        "resourceId": 0,
                        "lastTime": 1747734458,
                        "learnTime": 0,
                        "learnLocation": 0,
                        "examTime": 0,
                        "studyIntegral": 0,
                        "studyScore": 0,
                        "examScore": 0,
                        "studyTime": 0,
                        "completeFromSync": 0,
                        "completeFromAdmin": 0,
                        "syncTime": 0,
                        "batch": 0,
                        "progressTwoDigitStr": "",
                        "aiSparringScore": 0,
                        "aiSparringStatus": 0
                    }
                ],
                "authorizationTime": 0,
                "examStudyStatus": 0,
                "examScore": 0,
                "taskName": "string",
                "taskId": 0,
                "taskType": 0,
                "taskTypeName": "string",
                "batch": 0,
                "batchName": "string",
                "taskDepartmentPath": "string",
                "taskCreateUser": "string",
                "taskCreateAccount": "string",
                "taskStartTime": 0,
                "taskEndTime": 0
            }
        ],
        "page": 1,
        "pageSize": 30,
        "totals": 3
    }
}
🔴500返回错误消息
修改于 2025-05-26 10:50:59
上一页
获取学员培训项目数据
下一页
获取课程人员基础信息接口
Built with