操作日志接入

接口功能概述

第三方应用可以直接通过调用该接口,将用户操作日志发送到服务云。

接口说明

正式:https://zenith.fdcyun.com/v20/api/metrics/transfer/useractionlog.svc
测试:https://planet-test.fdcyun.com/v20/api/metrics/transfer/useractionlog.svc
批量上传正式地址:https://zenith.fdcyun.com/v20/api/metrics/transfer/useractionlog-list.svc
使用批量上传是body是下列实例的对象数组(建议使用批量上传,记录数不能超过1000条)
  • 调用方式: POST
  • 请求头信息(header)
x-token:xxxxx //调用服务云[认证接口]得到的token,未传输此头的请求无法获取数据
x-custid:xxxx //客户主数据GUID 
Content-Type: application/json; charset=utf-8
  • 请求体(body)
{
  "Time": "2019-03-19T14:17:14.4191327+08:00",
  "Operator": "Login",
  "User": {
    "UserCode": "lixxx",
    "UserName": "李xxx",
    "Role": "Admin"
  },
  "AppHost": {
    "AppName": "重构成本系统",
    "Version": "2.0.0",
    "Host": "MachineName1111",
    "Environment": "Product"
  },
  "Customer": {
    "CustomerGuid": "afc8c2f5-260b-4aca-85cc-bd48f4f39efa",
    "CustomerName": "地产公司名字地产公司名字地产公司名字"
  }
}
Response Body

成功返回,http状态码为 200

返回0 :表示成功接收到数据并入库,-1:表示数据成功接收但未找到对应的产品

失败返回,http状态码为 500

{
    "Message": "应用ID不存在",
    "ExceptionType":"System.Exception",
    "xxx": "xxx" //后续扩展
}

其他http状态码说明

代码 说明 附加说明
200 请求成功 返回值是-1时,表示使用日志数据中的AppHost.AppName,AppHost.Version,以及登录信息中的app_id未查询到对应的产品,请登录服务云平台中台核对日志发送的产品是否匹配
403 未授权
500 具体错误信息,如:没有产品信息

更新说明

  1. 20190326 初版,未考虑批量上传。
  2. 20200403 支持批量上传