Skip to content

飞书低代码平台-查询数据变更日志详情

根据日志 ID 查询数据变更日志详情

请求

项目
HTTP URLhttps://open.feishu.cn/open-apis/apaas/v1/applications/:namespace/audit_log/data_change_log_detail
HTTP MethodGET
接口频率限制10 次/秒
支持的应用类型custom,isv
权限要求 调用该 API 所需的权限。开启其中任意一项权限即可调用app_engine:security.audit_log:read 获取飞书低代码平台审计日志信息

请求头

名称类型必填描述
Authorizationstringuser_access_token 值格式:"Bearer access_token" 示例值:"Bearer u-7f1bcd13fc57d46bac21793a18e560" 了解更多:如何选择与获取 access token

路径参数

名称类型描述
namespacestring应用命名空间
示例值:"package_aaa"
数据校验规则
- 长度范围:01000 字符

查询参数

名称类型必填描述
log_idstring数据变更日志ID信息
示例值:7405456257290600492
数据校验规则
- 长度范围:01000 字符

响应

响应体

名称类型描述
codeint错误码,非 0 表示失败
msgstring错误描述
data\--
  └ dataaudit_log_detail数据变更日志详情信息
    └ log_idstring审计日志ID
    └ basic_infobasic_info日志基础信息
      └ log_typestring日志类型:10000-全部类型;10001-企业管理;10002-登录日志;10003-应用管理
      └ audit_scopestring审计域:15001-企业管理后台;15002-应用管理后台;15003-应用开发平台
      └ env_typestring环境类型:16001-沙箱环境;16003-线上环境
      └ app_idstring应用id
      └ modulestring审计日志功能模块
      └ op_typestring事件类型
      └ app_namemap<string, string>应用名称
    └ op_infoaudit_log_op_info审计日志操作信息
      └ operatorlookup_with_avatar操作人
        └ idstring用户ID
        └ namestring用户名称
        └ tenant_idstring租户ID
        └ emailstring用户邮箱
      └ outsiderboolean是否为外部用户,true代表是外部用户
      └ op_detailmap<string, string>操作详情内容
      └ statusstring操作状态:18001-成功;18002-失败
      └ failed_reasonstring失败原因
      └ failed_reason_i18nmap<string, string>多语类型失败原因
      └ op_timestring操作时间
      └ data_objectstring数据对象
      └ op_sourcestring操作源:20001-前端;20004-openapi
      └ data_changesstring\[\]数据变化(旧值和新值)
    └ login_infoaudit_log_login_info登录类型信息
      └ login_typestring登录类型:11001-飞书登录;11003-账号密码登录
    └ device_infoaudit_log_device_info设备信息
      └ device_idstring设备ID
      └ web_device_idstringweb端设备ID
      └ terminal_typestring终端类型:13002-PC类型;13003-Web类型
      └ os_typestring系统类型:14002-window;14001-未知
      └ os_versionstring系统版本
    └ net_infoaudit_log_net_info网络信息
      └ client_ipstring客户端IP
      └ ip_locstringIP位置
      └ ip_providerstringIP提供商
      └ refererstring引用页面
      └ originstring源页面
      └ user_agentstring用户代理

响应体示例

json
{
    "code": 0,
    "msg": "success",
    "data": {
        "data": {
            "log_id": "7376574450886557740",
            "basic_info": {
                "log_type": "10000",
                "audit_scope": "15001",
                "env_type": "16003",
                "app_id": "app123",
                "module": "17001",
                "op_type": "19001",
                "app_name": {
                    "zh": "应用名称"
                }
            },
            "op_info": {
                "operator": {
                    "id": "1768491480010814",
                    "name": "郭晋",
                    "tenant_id": "79844",
                    "email": "guojin.jim@bytedance.com"
                },
                "outsider": true,
                "op_detail": {
                    "language_code": 2052,
                    "text": "内部用户 赵四 登录了平台"
                },
                "status": "18001",
                "failed_reason": "登录失败",
                "failed_reason_i18n": {
                    "zh": "失败原因"
                },
                "op_time": "1723634726874",
                "data_object": "object_api_aaa",
                "op_source": "20001",
                "data_changes": [
                    "{\"old\": \"OldData\",\"new\": \"NewData\"}"
                ]
            },
            "login_info": {
                "login_type": "11001"
            },
            "device_info": {
                "device_id": "device_1234",
                "web_device_id": "webDevice_1234",
                "terminal_type": "2",
                "os_type": "14002",
                "os_version": "14.6"
            },
            "net_info": {
                "client_ip": "192.168.1.1",
                "ip_loc": "中国北京",
                "ip_provider": "ISP_com",
                "referer": "https://example.com/referer",
                "origin": "https://example.com/origin",
                "user_agent": "Mozilla/5.0 (iPhone; CPU iPhone OS 14_6 like Mac OS X) AppleWebKit/605.1.15 (KHTML, like Gecko) Mobile/15E148"
            }
        }
    }
}

错误码

HTTP状态码错误码描述排查建议
4002320001param is invalid检查请求入参

内容来源:飞书开放平台 · 自动爬取整理