Skip to content

上报审计日志

适用版本>=v7.0.2411b.20241128

接口说明:上报审计日志

请求说明

请求地址配置域名+/openapi+/v7/audit_logs
请求方法POST
签名方式KSO-1(配置域名+/openapi不参与签名)
权限要求查询和管理企业日志信息(应用授权) kso.audit_log.readwrite

请求头(Header)

Header参数类型是否必填说明
Content-Typestring使用:application/json
X-Kso-DatestringRFC1123 格式的日期,例: Wed, 23 Jan 2013 06:43:08 GMT
X-Kso-AuthorizationstringKSO-1 签名值,详见《签名方法》
Authorizationstring授权凭证,格式为:Bearer {access_token}

请求体(Body)

名称类型是否必填说明
whatobject操作对象
typestring日志类型,可选值:group:团队操作;login:登录操作;file:文件操作;admin:后台操作
op_keystring日志操作类型,由业务侧自行定义
detailstring操作明细
whenobject操作时间
op_start_timeint64操作开始时间
op_timeint64操作结束时间
whereobject操作地点
ip_addrstringip地址
whoobject操作地点
company_idstring操作企业ID
operator_idstring操作用户ID

请求体示例

json
{
  "what": {
    "detail": "string",
    "op_key": "string",
    "type": "group"
  },
  "when": {
    "op_start_time": 0,
    "op_time": 0
  },
  "where": {
    "ip_addr": "string"
  },
  "who": {
    "company_id": "string",
    "operator_id": "string"
  }
}

响应体(Response)

名称类型说明
codeint错误码
detailstring详细信息
msgstring状态信息
dataobjectnull

响应体示例

json
{
  "code": 0,
  "data": null,
  "detail": "",
  "msg": "ok"
}