获取员工标签列表
企业可通过此接口获取本应用后台维护的员工标签列表
请求方式: 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查询时返回) |