跳转到主要内容
POST
/
incident
/
post-mortem
/
basics
/
reset
更新故障复盘基础信息
curl --request POST \
  --url 'https://api.flashcat.cloud/incident/post-mortem/basics/reset?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "post_mortem_id": "8104935102bf89dc01ac638a5261fe7e",
  "incidents_highest_severity": "Warning",
  "incidents_earliest_start_seconds": 1761133512,
  "incidents_latest_close_seconds": 1761133632,
  "incidents_total_duration_seconds": 120,
  "responder_ids": [
    3790925372131
  ]
}
'
{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {}
}

限制说明

项目说明
速率限制每个账户 1,000 次/分钟50 次/秒
权限要求故障管理on-call

使用说明

  • 每次调用都会记录到账户审计日志,请不要把敏感信息放在请求字段中。

授权

app_key
string
query
必填

在 Flashduty 控制台 账户 → APP Key 中签发的 app_key。调用任何公开 API 时都必须携带。它等同于所属账户的身份凭证,请妥善保管。

请求体

application/json

写回复盘报告的故障基础信息。

post_mortem_id
string
必填

复盘 ID。

incidents_highest_severity
string
必填

关联故障中的最高严重级别。

incidents_earliest_start_seconds
integer<int64>
必填

最早关联故障开始时间的 Unix 秒级时间戳。

必填范围: x >= 1
incidents_latest_close_seconds
integer<int64>

最晚关联故障关闭时间的 Unix 秒级时间戳;仍未关闭时为 0。

必填范围: x >= 0
incidents_total_duration_seconds
integer<int64>

故障总持续时间,单位秒。

必填范围: x >= 0
responder_ids
integer<int64>[]

写入报告的响应人成员 ID。

响应

成功

成功响应结构。2xx 响应中 request_id 标识本次调用(同时出现在 Flashcat-Request-Id 响应头中),data 为接口业务 payload。失败响应使用不同结构,参见 ErrorResponse

request_id
string
必填

本次请求的唯一 ID,也会在 Flashcat-Request-Id 响应头中返回。反馈问题时请一并附上。

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
必填

空响应体。成功时服务端返回 data: null