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

批量增加修改用户信息

测试环境
https://api.test.tgtrain.cn
测试环境
https://api.test.tgtrain.cn
POST
/partner/member/batchadd
/partner/member 合作商_成员管理
增加/修改用户信息,根据account判断是否存在,不存在为新增,存在则修改现有信息。

请求参数

Query 参数
access_token
string 
企业密钥
必需
Body 参数application/json
memberlist
array [object {29}] 
增加修改用户集合
可选
userId
integer 
用户编号
可选
account
string 
*账号(必填)
必需
realName
string 
*姓名(必填)
必需
department
integer 
必需
*部门编号(Traingo编号)(与外部系统编号二选一必填)
departmentCode
string 
必需
部门编号(外部系统编号)(与Traingo编号二选一必填)
position
integer 
可选
岗位编号(Traingo编号)
positionCode
string 
可选
岗位编号(外部系统编号)(与Traingo编号二选一)
number
string 
工号
可选
mobile
string 
手机号
可选
nickName
string 
昵称
可选
openUid
string 
对接用户ID
可选
address
string 
地址
可选
fields
object 
自定义属性值
可选
birthday
string 
出生日期
可选
country
string 
国家
可选
province
string 
省份
可选
city
string 
市
可选
district
string 
区县
可选
director
integer 
直接主管
可选
email
string 
邮箱
可选
entryDate
string 
入职日期
可选
expireDate
string 
过期日期
可选
gender
integer 
性别 1男 2女
可选
identityId
string 
身份证
可选
identityType
integer 
可选
身份类型 1身份证 2护照 3台湾通行证 4港澳通行证
positionRank
string 
职称
可选
remarks
string 
备注
可选
tel
string 
座机号
可选
userType
integer 
可选
用户类型 1学员 2讲师 4教练 8管理员
示例
{
    "memberlist": [
        {
            "account": "test01",
            "realName": "test01",
            "departmentCode": "DP100101",
            "positionCode": "P001"
        },
        
        {
            "account": "test02",
            "realName": "test02",
            "departmentCode": "DP100101",
            "positionCode": "P002"
        }
    ]
}

示例代码

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/member/batchadd?access_token' \
--header 'Content-Type: application/json' \
--data-raw '{
    "memberlist": [
        {
            "account": "test01",
            "realName": "test01",
            "departmentCode": "DP100101",
            "positionCode": "P001"
        },
        
        {
            "account": "test02",
            "realName": "test02",
            "departmentCode": "DP100101",
            "positionCode": "P002"
        }
    ]
}'

返回响应

🟢200返回添加用户数
application/json
Body
data
string 
可选
ret
integer 
可选
返回状态 0成功 1失败
示例
{
    "data": "string",
    "ret": 0
}
🔴500返回错误消息
修改于 2025-01-03 03:22:16
上一页
增加岗位成员数据
下一页
批量删除用户
Built with