# 失败记录
回调失败的事件会被记录下来,业务方可以定期检查失败记录(如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 |
← 员工事件回调