# 失败记录

回调失败的事件会被记录下来,业务方可以定期检查失败记录(如1天检查一次),以进行异常数据恢复;恢复完成,可通过删除接口删除失败记录。

# 查询失败记录

请求方式: GET(HTTPS

请求地址: https://gateway.maxhub.com/hook/api/v1/client/fail_records?company_code={company_code}&start_time={start_time}&end_time={end_time}&page_no={page_no}&page_size={page_size}

参数说明:

参数 必须 说明
company_code 企业编码,即企业管理后台显示的企业ID(登录企业管理后台,在首页可以看到)
start_time 开始时间,格式为时间戳,精确到毫秒,如:1591329600000
end_time 结束时间,格式为时间戳,精确到毫秒,如:1591332300000
page_no 页码
page_size 每页记录数

返回结果:

{
  "page_no": 1,
  "page_size": 10,
  "total_pages": 1,
  "total_elements": 1,
  "records": [
    {
      "event_id": "8b2edc1f-a869-4d87-ae9f-1beec7a0c513",
      "event_type": "meeting_create",
      "data": {
        "meeting_no": "33366620200605001",
        "operator": {
          "open_user_id": "l1ZHBSAbRpxuMluQUKsuRorg_W-Ug"
        },
        "theme": "7.3 Kick Off",
        "start_time": 1591329600000,
        "end_time": 1591332300000,
        "room_id": "a7b94c9f-db44-49c9-ad0e-96ea6eb83f91",
        "address": "科学城H1栋A503",
        "content": "7.3 Kick Off 议程"
      },
      "create_time": 1591329600000,
      "update_time": 1591329600000,
      "retry_times": 3,
      "cause_by": "网络异常"
    }
  ]
}

参数说明:

参数 说明
page_no 页码
page_size 每页记录数
total_pages 总页数
total_elements 总记录数
records 失败记录
— event_id 事件ID
— event_type 事件类型
— data 事件内容,根据不同事件会有所不同
— create_time 创建时间
— update_time 更新时间
— retry_times 重试次数
— cause_by 失败原因

# 清除失败记录

请求方式: POST(HTTPS

请求地址: https://gateway.maxhub.com/hook/api/v1/client/fail_records/actions/clear

请求body:

{
  "company_code": "000111333",
  "start_time": 1591329600000,
  "end_time": 1591332300000
}

参数说明:

参数 必须 说明
company_code 企业编码,即企业管理后台显示的企业ID(登录企业管理后台,在首页可以看到)
start_time 开始时间,格式为时间戳,精确到毫秒,如:1591329600000
end_time 结束时间,格式为时间戳,精确到毫秒,如:1591332300000

返回结果:

{
  "message": "ok"
}

参数说明:

参数 说明
message 固定值ok