跳转到主要内容
POST
/
incident
/
post-mortem
/
template
/
upsert
创建或更新故障复盘模板
curl --request POST \
  --url 'https://api.flashcat.cloud/incident/post-mortem/template/upsert?app_key=' \
  --header 'Content-Type: application/json' \
  --data '
{
  "team_id": 2477033058131,
  "name": "Production incident template",
  "description": "Template for production incident reviews.",
  "content": "[{\"type\":\"heading\",\"content\":\"Summary\"}]",
  "content_markdown": "## Summary\nDescribe what happened."
}
'
{
  "request_id": "01HK8XQE3Z7JM2NTFQ5YJ8P9R4",
  "data": {
    "account_id": 2451002751131,
    "template_id": "post_mortem_default_tmpl_en-us",
    "name": "Default post-mortem report",
    "description": "Default sections for post-mortem reports.",
    "content": "[{\"type\":\"heading\",\"content\":\"Summary\"}]",
    "content_markdown": "## Summary\nDescribe what happened.",
    "team_id": 2477033058131,
    "created_at_seconds": 1773900000,
    "updated_at_seconds": 1773903600
  }
}

限制说明

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

使用说明

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

授权

app_key
string
query
必填

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

请求体

application/json

创建或更新故障复盘模板的参数。

name
string
必填

模板名称。

content
string
必填

BlockNote JSON 模板内容。

template_id
string

模板 ID。创建新模板时省略;更新已有模板时传入。

team_id
integer<int64>

管理团队 ID。创建自定义模板时必填。

description
string

模板描述。

content_markdown
string

模板内容的 Markdown 版本。

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
必填

故障复盘报告模板。