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

获取学员培训项目数据

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

请求参数

Query 参数
access_token
string 
企业密钥
必需
示例值:
myzdk0zcoyDdXgi6DeQvMInzbD65W7mcyofADnOS2xMyLKzXu95xNYBMJEJbLGe3Bv6W2dKV8sJxONPgnBC4gfVxeCEBnTmxcWKZ2LwX8OsUASALTBLlWa2OXcsVLnmmFHNSy8G8oo00oUBHRsQn6Imcoo00oZYjorM1b41GVznacMGuQPbh7poFci81q1xhTQm7Xo3m
Body 参数application/json
page
integer 
页码
必需
pageSize
integer 
每页数
必需
complete
integer 
可选
进行状态: 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)
isopendistributeaccount
integer 
可选
是否开启账号分发 1是 2否
示例
{
    "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?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
array [object {89}] 
可选
userId
integer 
学员编号
可选
account
string 
学员账号
可选
realName
string 
学员姓名
可选
nickName
string 
学员昵称
可选
birthday
integer 
学员生日
可选
departmentId
integer 
学员所属部门编号
可选
departmentName
string 
学员所属部门名称
可选
department
string 
学员所属部门路径
可选
departmentCode
string 
学员所属部门机构编码
可选
positionId
integer 
学员所属岗位编号
可选
position
string 
学员所属岗位名称
可选
positionRank
string 
学员职称
可选
country
string 
学员所属国家
可选
province
string 
学员所属省份
可选
city
string 
学员所属城市
可选
district
string 
学员所属区县
可选
email
string 
学员邮箱
可选
portrait
string 
学员头像
可选
expireDate
integer 
学员账号到期日期
可选
entryDate
integer 
学员入职日期
可选
address
string 
学员地址
可选
number
string 
学员工号
可选
identityId
string 
学员身份证
可选
mobile
string 
学员手机号
可选
tel
string 
学员电话
可选
remarks
string 
学员备注信息
可选
directorId
integer 
学员直接主管编号
可选
director
string 
学员直接主管
可选
directorAccount
string 
学员直接主管账号
可选
createUid
integer 
学员创建人编号
可选
createUser
string 
学员创建人
可选
createTime
integer 
学员创建时间
可选
platforms
string 
学员账号绑定平台列表
可选
gender
integer 
学员性别
可选
1男 2女
userType
integer 
学员类型
可选
1学员 2讲师 4教练 8管理员
activate
integer 
学员激活状态
可选
1 正常-已激活 0正常-未激活
identityType
integer 
身份类型
可选
1身份证 2护照 3台湾通行证 4港澳通行证
labelIds
null 
标签ID集合
可选
labelNames
null 
标签名称集合
可选
所属用户群
label
string 
标签名称
可选
labelIDss
null 
标签ID集合
可选
labels
null 
标签集合
可选
openUid
string 
对接用户ID
可选
distributeaccount
string 
业务账号
可选
joinTime
integer 
加入时间
可选
memberActivate
string 
激活状态
可选
startTime
integer 
开始学习时间
可选
endTime
integer 
结束学习时间
可选
completeTime
integer 
完成时间
可选
lastTime
integer 
最后学习时间
可选
learnTime
integer 
学习时长
可选
单位:秒
exams
integer 
及格考试场次
可选
examTime
integer 
所有考试时长
可选
单位:秒
progress
integer 
学习进度
可选
最大值:100
progressTwoDigitStr
string 
学习进度
可选
保留两位小数
sectionProgress
integer 
课程章节进度
可选
complete
integer 
任务状态
可选
1完成 2进行中 3逾期未完成
qualifier
integer 
合格状态
可选
1合格、2不合格
studyDetails
null 
项目明细学习数据
可选
authorizationTime
integer 
授权时间
可选
courseStudyStatus
integer 
课程学习状态
可选
1已完成 2未学习 3未完成
examStudyStatus
integer 
考试学习状态
可选
1通过、2不通过、0未参与
homeworkStudyStatus
integer 
作业学习状态
可选
1通过 2申请 3不通过 4保存
homeworkScore
integer 
作业得分
可选
examScore
integer 
考试得分
可选
questionnaireSubmitTime
integer 
评分-提交时间
可选
questionnaireScore
integer 
评分-得分
可选
completeFromSync
integer 
完成来源于同步
可选
0/1
departmentLevel
null 
部门层级
可选
taskName
string 
项目名称
可选
taskId
integer 
项目编号
可选
taskType
integer 
项目类型
可选
任务类型 1培训项目 5专题培训 6学习地图 9新员工培训 10考试任务
taskTypeName
string 
项目类型名称
可选
status
integer 
状态
可选
状态 1可用 2不可用 5未发布 6未审核 7审核未通过 8停用 9删除
isOpenDistributeAccount
integer 
是否开启账号分发
可选
0/1
openFaceCount
integer 
识别总次数
可选
人脸识别
openFaceFailCount
integer 
识别失败次数
可选
人脸识别
batch
integer 
批次
可选
新人培训周期
batchName
string 
批次名称
可选
新人培训周期
memberFieldKVMap
null 
用户信息
可选
completeFromAdmin
integer 
完成方式
可选
0自主完成 1管理员操作完成
firstTime
integer 
首次学习时间
可选
courseCompleteStatus
integer 
课程完成状态
可选
completeStatus
integer 
任务完成状态
可选
状态 1完成 2未完成
taskDepartmentPath
string 
任务所属部门全路径
可选
taskCreateUser
string 
任务创建人
可选
taskCreateAccount
string 
任务创建人账号
可选
taskStartTime
integer 
任务开始学习时间
可选
taskEndTime
integer 
任务结束学习时间
可选
示例
{
    "ret": 0,
    "data": [
        {
            "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,
            "label": "string",
            "labelIDss": null,
            "labels": null,
            "openUid": "string",
            "distributeaccount": "string",
            "joinTime": 0,
            "memberActivate": "string",
            "startTime": 0,
            "endTime": 0,
            "completeTime": 0,
            "lastTime": 0,
            "learnTime": 0,
            "exams": 0,
            "examTime": 0,
            "progress": 0,
            "progressTwoDigitStr": "string",
            "sectionProgress": 0,
            "complete": 0,
            "qualifier": 0,
            "studyDetails": null,
            "authorizationTime": 0,
            "courseStudyStatus": 0,
            "examStudyStatus": 0,
            "homeworkStudyStatus": 0,
            "homeworkScore": 0,
            "examScore": 0,
            "questionnaireSubmitTime": 0,
            "questionnaireScore": 0,
            "completeFromSync": 0,
            "departmentLevel": null,
            "taskName": "string",
            "taskId": 0,
            "taskType": 0,
            "taskTypeName": "string",
            "status": 0,
            "isOpenDistributeAccount": 0,
            "openFaceCount": 0,
            "openFaceFailCount": 0,
            "batch": 0,
            "batchName": "string",
            "memberFieldKVMap": null,
            "completeFromAdmin": 0,
            "firstTime": 0,
            "courseCompleteStatus": 0,
            "completeStatus": 0,
            "taskDepartmentPath": "string",
            "taskCreateUser": "string",
            "taskCreateAccount": "string",
            "taskStartTime": 0,
            "taskEndTime": 0
        }
    ]
}
🔴500返回错误消息
修改于 2025-05-21 08:07:15
上一页
获取移动端首页第一个推荐课程 *
下一页
获取学员培训项目数据 V2
Built with