跳转到主要内容
POST
删除战情室

限制说明

使用说明

  • 先删除作战室记录;IM 侧解散群组失败(例如群组已被解散)会被忽略。
  • 故障在该集成上没有作战室时直接返回成功,不做任何变更。
  • 如果只想解除关联(适用于 IM 集成已禁用或已删除的情况),设置 unlink_only: true 并传入该作战室的 chat_id。此模式仅限账户所有者和管理员使用,集成仍处于启用状态时返回 InvalidParameter,且不会解散群组。
  • 成功时响应不含 data 字段。

授权

app_key
string
query
必填

在 Flashduty 控制台 我的 → APP Key 中创建的 APP Key。可通过 query 参数 app_key 或请求头 Fd-App-Key 传入。实际可访问范围是该 APP Key 的权限范围与创建者当前角色权限的交集,请妥善保管。

请求体

application/json

删除故障战情室的参数。

incident_id
string
必填

故障 ID(MongoDB ObjectID)。

Pattern: ^[0-9a-fA-F]{24}$
integration_id
integer<int64>
必填

IM 集成 ID,可通过 POST /datasource/im/war-room-enabled/list 获取。

为 true 时只解除故障与作战室的关联,不解散群组。仅限账户所有者和管理员,仅在 IM 集成已禁用或已删除时可用,且必须传 chat_id。

chat_id
string

要解除关联的作战室群 ID,取自 POST /incident/war-room/list。unlink_only 为 true 时必填,且必须与当前作战室一致;其他情况忽略。

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

无返回数据。不同接口的 data 可能是 {},也可能不出现在响应中;请只根据 HTTP 200 且没有 error 判断成功。