Skip to main content
POST
创建状态页草稿

限制说明

使用说明

  • draft 载荷将被原样存储(最大 64 KB);控制台发布表单会读取它来预填事件内容。
  • 草稿保留 30 天,事件发布时被消费且仅可消费一次。
  • 每次调用都会记录到账户审计日志,请勿在请求字段中写入敏感信息。

授权

app_key
string
query
必填

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

请求体

application/json

存储状态页草稿的参数。draft 载荷将被原样存储,仅下列被校验的字段会被解析。

draft
object
必填

草稿载荷,原样存储,序列化后最大 64 KB。被校验的字段:page_idtypeincidentmaintenance)、namemessage;可选 change_id(大于 0 时表示向已有事件追加进展)、statusaffected_components,以及 start_time/end_time(Unix epoch 秒,仅新建维护窗口时使用)。

source
string

草稿来源的不透明标记,例如 ai_sre:sess_xxx。最长 64 个字符。

Maximum string length: 64

响应

Success

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
必填

存储状态页草稿的结果。