获取员工标签列表

企业可通过此接口获取本应用后台维护的员工标签列表

请求方式: POST(HTTPS)

请求地址: https://open.wshoto.com/openapi/groupChatTool/template/queryTagPageList

Query参数:

参数 类型 必填 说明
access_token string 调用接口凭证

Body参数:

{
  "current_index": "1",
  "page_size": "20",
  "search_value": "",
  "tag_id_list": [
    ""
  ],
  "user_id": ""
}
参数 类型 必填 说明
current_index integer 当前页
page_size integer 每页大小
search_value string 搜索条件 标签名称
tag_id_list List 员工标签id 最大100个,可根据此参数精确获取某员工标签的详情信息
tag_id和user_id必须填写一个,两个都填仅tag_id生效
user_id string 查看人userid,由于本应用后台的「员工标签」不同身份能查看的数据范围不同,因此需要选择一个查看人的视角,若需获取全部标签,传入本应用超管的userid即可(可从本应用后台通讯录的成员详情页面账号里获取userid)
tag_id和user_id必须填写一个,两个都填仅tag_id生效

返回值:

{
  "code": 0,
  "sub_code": "",
  "msg": "",
  "data": {
    "total": 0,
    "records": [
      {
        "tag_id": "",
        "tag_name": "",
        "create_time": 0,
        "create_user": "",
        "create_source": "",
        "deleted": 0
      }
    ]
  }
}

参数说明:

参数 类型 说明
code int 返回码,0-请求成功,
msg string 对返回码的文本描述内容
data object 响应结果
  total integer 总行数
  records List 数据列表
      tag_id string 员工标签id
      tag_name string 员工标签名称
      create_time integer 创建时间
      create_user string 创建人
      create_source string 创建来源,QW_SYNC:企业微信同步;OPEN_API:本应用API创建;PC_BACKEND:PC端后台创建
      deleted integer 是否删除 0否,1是(已删除的数据仅指定tag_id_list查询时返回)

results matching ""

    No results matching ""