跳转到主要内容
POST
添加故障处理人员

限制说明

使用说明

  • 已有处理人保持不变,已经是处理人的 ID 会被跳过。如需替换整组处理人,请使用 POST /incident/assign。
  • 已关闭的故障返回 InvalidParameter。
  • 账户中不存在的成员 ID 会被忽略。
  • 新处理人按 notify 设置接收通知;默认按各自的个人通知偏好发送。

授权

app_key
string
query
必填

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

请求体

application/json

向已有故障添加处理人员的参数。person_ids 与 team_ids 至少要提供一个。

incident_id
string
必填

故障 ID(MongoDB ObjectID)。

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

要添加为处理人的成员 ID(最多 100 个)。已经是处理人或账户中不存在的 ID 会被跳过。

Maximum array length: 100
team_ids
integer<int64>[]

按团队添加处理人时的团队 ID 列表(最多 20 个)。每个团队展开为状态为启用的成员后与 person_ids 合并,处理人员总数上限为 100。

Maximum array length: 20
notify
object

新加入处理人的通知设置。默认 {"follow_preference": true}。

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

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