企业内部开发
基础
连接微信
办公
会议
会议统计管理
企业内部开发
服务端API
安全管理
操作日志
获取管理端操作日志
获取管理端操作日志
最后更新:2024/09/13

目录

  • 概述
  • 接口调用说明
  • 操作行为类型说明
  • 概述

    管理端操作日志,可以在管理端“使用分析”中查看。为了方便企业对接内部系统,设定相应规则以进行定时的安全预警,允许通过接口读取。

    enter image description here

     

    若要调此接口,需要在上图中“API”栏,配置到“可调用接口应用”列表。
    因为成员操作记录数据量较大,该接口设计为增量读取接口,且有较严格的频率限制。开发者需酌情定时调用,读取合适的时间段的记录。

    接口调用说明

    请求方式:POST(HTTPS)

    请求地址: https://qyapi.weixin.qq.com/cgi-bin/security/admin_oper_log/list?access_token=ACCESS_TOKEN

    请求示例

    {
        "start_time": 1724256000,
        "end_time": 1724860799,
        "oper_type": 1,
        "userid": "sam",
        "cursor": "xxxxx",
        "limit": 2
    }

    参数说明:

    参数必须类型说明
    access_tokenstring调用接口凭证
    start_timeuint64开始时间
    取值范围:不早于180天前
    end_timeuint64结束时间
    取值范围:大于start_time,小于当前时间。开始时间和结束时间之间的跨度不能超过7天。
    oper_typeuint32操作类型。不填表示全部
    取值范围目前支持如下:
        2 - 权限管理变更
        3 - 成员与部门变更
        7 - 其它
        8 - 应用变更
        11 - 通讯录与聊天管理
        12 - 企业信息管理
        13 - 外部联系人管理
    useridstring操作者userid
    cusorstring分页游标。不填表示首页
    limituint32最大记录数。不填默认最多获取400个记录
    取值范围:1 ~ 400
    注意:不保证每次返回的数据刚好为指定limit ,必须用返回的 has_more 判断是否继续请求

     

    1. 接口调用产生的操作日志(如通讯录同步助手)不会返回。
    2. 默认返回所有管理端操作日志,不会进行应用可见范围的筛选。
    3. 接口调用频率限制为600次/分钟。

    权限说明: (需具有「获取管理端操作日志」权限)

    返回结果:

    {
    	"errcode": 0,
    	"errmsg": "ok",
    	"has_more": true,
    	"next_cursor":"xxxx",
    	"record_list": [
    	    {
    			"time": 1724256000,
    			"userid": "sam",
    			"oper_type": 1,
    			"detail_type": 2,
    			"detail_info": "姓名:shel;手机号:15622244106",
    			"ip": "183.40.88.11"
    		},
    		{
    			"time": 1724256400,
    			"userid": "sam",
    			"oper_type": 1,
    			"detail_type": 2,
    			"detail_info": "姓名:abel;手机号:15622244108",
    			"ip": "61.40.122.129"
    		}
    	]
    }

    参数说明:

    参数类型说明
    errcodeint32返回码
    errmsgstring错误码描述
    has_morebool是否还有下一页
    next_cursorstring下一页的分页游标。不同过滤条件的的cursor不能混用
    record_listobj[]记录列表
    record_list.timeint64操作时间
    record_list.useriduint64操作者userid
    record_list.oper_typeuint32操作类型
    record_list.detail_typeuint32操作行为。详见后面说明
    record_list.detail_infostring相关数据
    record_list.ipstring操作者ip

     

    操作行为类型说明

    操作行为,目前有以下类型:

    1 - 绑定手机
    2 - 解绑手机
    3 - 修改密保邮箱
    4 - 修改登录密码
    5 - 新增分级管理员
    6 - 删除分级管理员
    7 - 更改操作权限
    8 - 更改管理范围
    9 - 新增部门
    10 - 删除部门
    11 - 移动部门
    12 - 移动成员
    13 - 删除成员
    14 - 新增成员
    15 - 更改成员信息
    16 - 批量导入
    17 - 更改企业名称
    18 - 更改企业logo
    19 - 更改企业信息
    20 - 更改消息设置
    21 - 更改部门信息
    22 - 发送公告
    23 - 登录后台
    24 - 移除成员
    25 - 发送邀请
    26 - 新增应用
    27 - 删除应用
    28 - 修改应用主页
    29 - 修改应用可见范围
    30 - 导出通讯录
    31 - 新增管理组
    32 - 删除管理组
    33 - 修改管理组名称
    34 - 修改管理组通讯录权限
    35 - 修改管理组应用权限
    36 - 修改管理组管理员列表
    37 - 转让创建人
    38 - 新增标签
    39 - 删除标签
    40 - 变更标签成员
    41 - 修改标签名称
    42 - 安装套件应用
    43 - 删除套件应用
    44 - 删除通讯录套件
    45 - 安装通讯录套件
    46 - 开通企业微信
    47 - 新增素材
    48 - 编辑素材
    49 - 删除素材
    50 - 隐藏部门/成员
    51 - 限制查看外部门
    52 - 限制查看所有人
    53 - 添加发票信息
    54 - 修改发票信息
    55 - 删除发票信息
    56 - 删除套件应用
    57 - 开启自动邀请成员使用
    58 - 关闭自动邀请成员使用
    59 - 变更应用权限
    60 - 增量更新成员
    61 - 全量覆盖成员
    62 - 全量覆盖部门
    63 - 导出客服列表
    64 - 删除客服
    65 - 启用应用
    66 - 停用应用
    67 - 添加审批模板
    68 - 启用审批模板
    69 - 停用审批模板
    70 - 删除审批模板
    71 - 修改审批模板
    72 - 修改审批规则
    73 - 删除审批记录
    74 - 添加审批假期类型
    75 - 删除审批假期类型
    76 - 修改审批假期类型
    77 - 导入审批假期余额
    78 - 修改个人假期余额
    79 - 添加打卡规则
    80 - 修改打卡规则
    81 - 删除打卡规则
    82 - 修改外出打卡设置
    83 - 添加汇报模板
    84 - 启用汇报模板
    85 - 停用汇报模板
    86 - 删除汇报模板
    87 - 修改汇报模板
    88 - 修改汇报规则
    89 - 导出汇报记录
    90 - 导出审批假期余额
    91 - 导出审批记录
    92 - 导出打卡记录
    93 - 通过提交资料认证
    94 - 法定代表人验证
    95 - 支付验证
    96 - 通过微信公众号授权验证
    97 - 通过微信公众号授权认证
    98 - 设置进入企业二次验证
    99 - 修改申请加入企业设置
    100 - 修改客户端启动页
    101 - 离职成员管理
    102 - 设置一周小结
    103 - 修改微信插件logo
    104 - 修改微信插件功能介绍
    105 - 修改微信插件设置
    106 - 设置邀请同事领红包
    107 - 设置群成员人数上限
    108 - 设置消息阅读状态
    109 - 设置全员群
    110 - 自动创建部门群
    111 - 设置成员资料显示
    112 - 设置成员可修改字段
    113 - 设置成员排序规则
    114 - 设置聊天显示水印
    115 - 设置通讯录水印
    116 - 设置未使用成员接收消息提醒
    117 - 设置手机号安全查看
    118 - 设置成员对外联系人信息显示
    119 - 修改外部联系人权限设置
    120 - 导出相关操作记录
    121 - 修改工作台显示
    122 - 设置成员可见第三方应用入口
    123 - 启用小程序
    124 - 停用小程序
    125 - 添加聊天附件栏小程序页面
    126 - 编辑聊天附件栏小程序页面
    127 - 删除聊天附件栏小程序页面
    128 - 应用与小程序分组编辑
    129 - 设置成员可见连接微信入口
    130 - 设置通讯录API同步
    132 - 设置安全查看信息
    133 - 导出全量成员查看记录
    134 - 导出指定成员的查看记录
    135 - 会话内容存档修改IP地址
    136 - 会话内容存档修改消息加密公钥
    137 - 设置会话内容存档成员的语音/视频通话功能
    138 - 设置会话内容存档成员的文件传输助手
    139 - 设置会话内容存档的服务须知
    140 - 会话内容存档修改开启范围
    141 - 设置会话内容存档的会话限制
    142 - 主体资料验证
    146 - 会话内容存档设置消息关键词拦截
    147 - 新增部门
    148 - 删除部门
    149 - 修改部门
    150 - 新增学生
    151 - 删除学生
    152 - 修改学生信息
    153 - 新增家长
    154 - 删除家长
    155 - 修改家长信息
    156 - 批量导入
    157 - 修改设置
    158 - 设置家校通讯录API同步
    159 - 查看Secret
    160 - 设置接收事件服务器回调
    161 - 重置Secret
    162 - 批量设置成员信息
    163 - 删除并禁用应用
    164 - 关闭成员授权
    165 - 取消应用禁用
    166 - 修改应用授权方式
    167 - 开启成员授权
    168 - 开启管理端登录短信验证
    169 - 关闭管理端登录短信验证
    170 - 调整自建应用为代开发自建应用
    171 - 设置通讯录人数显示
    172 - 企业可信IP
    173 - 授权通讯录编辑权限
    174 - 取消授权通讯录编辑权限
    175 - 群成员列表展示性别
    176 - 删除成员(操作离职)
    177 - 批量导入花名册
    178 - 批量更新花名册
    179 - 代运营服务人员权限变更
    180 - 导出通讯录(花名册)
    181 - 企业微信认证
    182 - 批量导出
    185 - 停用Secret
    186 - 停用接收事件服务器
    189 - 创建知识集
    190 - 修改知识集
    191 - 删除知识集

    上一篇获取成员操作记录
    下一篇获取企业微信域名IP信息
      本节内容
    服务端API
    基础
    连接微信
    办公
    会议
    会议统计管理
    客户端API
    小程序
    基础
    连接微信
    办公
    WECOM-JSSDK
    JS-SDK
    基础
    连接微信
    办公
    更新日志
    联系我们