跳转到主要内容
POST
添加作战室成员

限制说明

使用说明

  • 需要 On-call Pro 许可。
  • chat_id 必须对应通过 Flashduty 在集成 integration_id 上创建的作战室,否则返回 ResourceNotFound。
  • 仅飞书、钉钉、企业微信和 Slack 集成支持作战室;其他集成返回 InvalidParameter。
  • member_ids 中的每个 ID 都必须是本账户的人员;任一 ID 无效则整个请求失败。
  • 成功时 data 为字符串 ok。

授权

app_key
string
query
必填

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

请求体

application/json
integration_id
integer<int64>
必填

承载作战室的 IM 集成 ID,可通过 POST /datasource/im/war-room-enabled/list 获取。

chat_id
string
必填

作战室群在 IM 平台上的会话 ID,可从 POST /incident/war-room/list 返回的作战室信息中获取。

member_ids
integer<int64>[]
必填

要添加的人员 ID(成员 ID;账户所有者为账户 ID)。不能为空。

Minimum array length: 1

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
string

成功时返回字面量 "ok"。