企业成员管理

获取企业内所有成员
获取组织机构内成员
创建成员
删除成员
更新成员
成员信息变更同步

获取企业内所有成员

请求方式： GET
请求地址：https://open.qingtui.com/team/member/all/paged?access_token=ACCESS_TOKEN&page_size=PAGE_SIZE&request_page=REQUEST_PAGE

参数说明：

参数 必须 说明
access_token 是 接口调用凭证
page_size 是 分页返回时每页数据量，最大100
request_page 是 请求的页数，从1开始

正确返回结果示例：

{
    "total_count": 2,
    "has_more": true,
    "result_list": [
        {
            "name": "张三",
            "mail": null,
            "avatar": "https://avatarcdn.qingtui.cn/00XX.jpg",
            "comment": null,
            "guest": "yes",
            "mobile": "18000000000",
            "user_id":"userid002",
            "org_list": ["1ea6731d322548"],
            "employee_id":00001
        },
        {
            "name": "李四",
            "mail": "lisi@qingtui.cn",
            "avatar": "https://avatarcdn.qingtui.cn/00YY.jpg",
            "comment": "测试用户",
            "guest": "no",
            "mobile": "15111111111",
            "user_id":"userid001",
            "org_list": ["1ea6731d322548"],
            "employee_id":00001
         }
    ]
}

出错返回结果示例： 

{
    "errcode": "40100",
    "errmsg": "page_size must be an integer less than  or equals to 100"
}

参数说明：

参数 说明
total_count 企业人员总数，含访客
has_more 是否还有更多未读的数据
name 名称
mail 邮箱
avatar 头像
comment 备注
guest 是否访客，yes是；no否
mobile 手机号码
user_id 企业内用户Id
org_list 所在的组织机构列表
employee_id 工号
errcode 错误代号
errmsg 错误信息

备注：

  1. 需要拥有读取企业成员信息的权限

获取组织机构内成员

请求方式： GET
请求地址：https://open.qingtui.com/team/member/org/paged?access_token=ACCESS_TOKEN&org_id=ORG_ID&page_size=PAGE_SIZE&request_page=REQUEST_PAGE

参数说明：

参数 必须 说明
access_token 是 接口调用凭证
org_id 是 组织机构Id，值为root时，为第一级组织机构
page_size 是 分页返回时每页数据量，最大100
request_page 是 请求的页数，从1开始

正确返回结果示例：

{
    "total_count": 2,
    "has_more": true,
    "result_list": [
        {
            "name": "张三",
            "mail": null,
            "avatar": "https://avatarcdn.qingtui.cn/00XX.jpg",
            "comment": null,
            "guest": "yes",
            "user_id":"id001",
            "mobile": "18000000000",
            "org_list": [
                "org_id0001"
            ],
            "employee_id":00001
        },
        {
            "name": "李四",
            "mail": "lisi@163.com",
            "avatar": "https://avatarcdn.qingtui.cn/00YY.jpg",
            "comment": "测试用户",
            "guest": "no",
            "user_id":"id002",
            "mobile": "15111111111",
            "org_list": [
                "org_id0001"
            ],
            "employee_id":00001

         }
    ]
}

出错返回结果示例： 

{
    "errcode": "40100",
    "errmsg": "page_size must be an integer less than or equals to 100"
}

参数说明：

参数 说明
total_count 仅当前组织机构下用户数量（含访客），不包括子组织机构
has_more 是否还有更多的未读数据
name 名称
mail 邮箱
avatar 头像
comment 备注
guest 是否访客，yes是；no否
mobile 手机号码
user_id 企业内用户Id
org_list 组织机构列表
employee_id 工号
errcode 错误代号
errmsg 错误信息

备注：

  1. 此接口获取的用户仅为当前组织机构下的用户，不递归包含子组织机构用户
  2. 需要拥有读取企业成员信息的权限

创建成员

请求方式： POST
Content-Type:application/x-www-form-urlencoded
请求地址：https://open.qingtui.com/team/member/create/single?access_token=ACCESS_TOKEN

请求示例： 

name:第一个成员
comment:测试
mail:XXXXX@163.com
mobile:18000000000
org_list[0]:09d2fadce
org_list[1]:09d2fadcd
password:qingtuitest
employee_id:00001

参数说明：

参数 必须 说明
access_token 是 接口调用凭证
name 是 成员名字
mail 否 电邮地址
comment 否 备注
mobile 是 电话号码
org_list 否 所在的组织机构列表
password 是 初始用户密码
employee_id 否 工号

正确返回结果示例：

{
     "user_id":"user001"
}

出错返回结果示例： 

{
    "errcode": "40402",
    "errmsg": "invalid token"
}

参数说明：

参数 说明
user_id 企业内用户Id
errcode 错误代号
errmsg 错误信息

备注：

  1. 轻应用需要拥有变更企业成员的权限

删除成员

请求方式： POST Content-Type:application/x-www-form-urlencoded
请求地址：https://open.qingtui.com/team/member/delete/single?access_token=ACCESS_TOKEN

请求示例： 

user_id:user001

参数说明：

参数 必须 说明
access_token 是 接口调用凭证
user_id 否 企业内用户Id

返回结果：

{
    "errcode": "0",
    "errmsg": "success"
}

参数说明：

参数 说明
errcode 错误代号，成功为0
errmsg 错误信息，如果成功是success，失败则显示失败原因

备注：

  1. 轻应用需要拥有变更企业成员信息的权限

更新成员

请求方式： POST
Content-Type:application/x-www-form-urlencoded
请求地址：https://open.qingtui.com/team/member/update/single?access_token=ACCESS_TOKEN

请求示例： 

user_id:user002
comment:更新成员信息测试
name:张某某
org_list[0]:09d2fadce
org_list[1]:09d2fadcd
employee_id:00001

参数说明：

参数 必须 说明
access_token 是 接口调用凭证
user_id 是 企业内用户Id
name 否 要修改的名字
org_list 否 所在的组织机构列表
comment 否 要修改的备注信息
employee_id 否/工号

返回结果示例：

{
    "errcode": "0",
    "errmsg": "success"
}

参数说明：

参数 说明
errcode 错误代码，成功为0
errmsg 错误信息，如果成功是success，失败则显示失败原因

备注：

  1. 轻应用需要拥有变更企业成员信息的权限
  2. 不需要修改的字段可不传输，否则若传输为空值，则会删除以前的旧值

获取用户详情

请求方式： GET
请求地址：https://open.qingtui.com/team/member/detail?access_token=ACCESS_TOKEN&user_id=USER_ID

参数说明：

参数 必须 说明
access_token 是 接口调用凭证
user_id 是 企业内用户Id

正确返回结果示例：

{
    "user_id": "9dea319994aa526ea",
    "name": "张三",
    "mail": "zhangsan@163.com",
    "avatar": null,
    "comment": "测试用例",
    "guest": "no",
    "mobile": "18623000000",
    "org_list": [
        "org_001"
    ],
    "employee_id":00001
 }

出错返回结果示例： 

{
    "errcode": "40402",
    "errmsg": "invalid token"
}

参数说明：

参数 说明
user_id 企业内用户Id
name 成员名字
mail 电邮地址
avatar 头像地址
comment 备注
mobile 电话号码
guest 是否访客，yes表示是
org_list 所在的组织机构列表
employee_id 工号
errcode 错误代号
errmsg 错误信息

备注：

  1. 轻应用需要拥有变更企业成员信息的权限

成员信息变更同步

请求方式： GET
请求地址：https://open.qingtui.com/team/member/sync?access_token=ACCESS_TOKEN&sync_time=SYNC_TIME&page_size=PAGE_SIZE&request_page=REQUEST\_PAGE

参数说明：

参数 必须 说明
access_token 是 接口调用凭证
sync_time 是 要同步的时间戳，毫秒格式，从此时间（含）后的变更都会返回
page_size 是 请求的每页成员数量
request_page 是 请求的页码，从1开始

返回结果：

{
    "total_count": 20,
    "has_more": true,
    "result_list": [
        {
            "name": "张三",
            "mail": null,
            "avatar": "https://avatarcdn.qingtui.cn/0000.jpg",
            "comment": null,
            "guest": "no",
            "mobile": "18500000000",
            "user_id":"user001",
            "update_time": 1496753901123,
            "org_list": [
                "",
                "5998de4ee8"
            ],
            "status":1,
            "employee_id":00001
        },

        {
            "name": "李四",
            "mail": "",
            "avatar": "https://avatarcdn.qingtui.cn/0002.jpg",
            "comment": "",
            "guest": "no",
            "mobile": "13500000000",
            "user_id": "09d3858c0d0",
            "update_time": 1496753901001,
            "org_list": [
                "1ea6731d32",
                "5998de4ee8"
            ],
            "status":0,
            "employee_id":00001
        }
    ]
}

出错返回结果示例： 

{
    "errcode": "40402",
    "errmsg": "invalid token"
}

参数说明：

参数 说明
total_count 变更发生的总人数
has_more 是否还有更多的未读数据
name 名称
mail 邮箱
avatar 头像
comment 备注
guest 是否访客，yes是；no否
mobile 手机号码
org_list 所在的组织机构列表
update_time 更新时间戳（毫秒格式）
status 状态，0退出企业，1在企业中
employee_id 工号
errcode 错误代号
errmsg 错误信息

备注:

  1. 轻应用需要拥有读取企业成员信息的权限

results matching ""

    No results matching ""