跳转到主要内容
POST
查询跟进事项列表

限制说明

使用说明

  • incident_id、post_mortem_id、assignee_id 或 assignee_type = ai_sre 至少提供一个。
  • 按 incident_id 或 post_mortem_id 过滤时,须有该故障或复盘的查看权限;按 incident_id 查询时,若调用方可查看该故障的复盘,也会返回绑定到该复盘的后续行动。
  • 仅按 assignee_id 查询时,调用方须为该成员本人,或账户所有者、管理员。未指定 incident_id 和 post_mortem_id 时,非所有者或管理员只能看到其有权查看的故障或复盘下的事项。
  • 按 updated_at_seconds 降序排列。将上一次响应中的 next_cursor 作为 cursor 传入,直到 has_more 为 false。

授权

app_key
string
query
必填

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

请求体

application/json

查询跟进事项的过滤条件。incident_id、post_mortem_id、assignee_id,或 assignee_type 为 ai_sre,至少满足一个。

incident_id
string

故障 ID(MongoDB ObjectID)。同时返回锚定在该故障复盘上的后续行动。

Pattern: ^[0-9a-fA-F]{24}$
post_mortem_id
string

故障复盘 ID(32 位十六进制字符串)。返回绑定到该复盘的后续行动。

item_type
enum<string>

按事项类型过滤:action 行动项,follow_up 复盘跟进项。

可用选项:
action,
follow_up
assignee_id
integer<int64>

只返回指派给该成员 ID 的事项。仅按负责人查询时,调用方须为该成员本人,或账户所有者、管理员。assignee_type 为 ai_sre 时忽略。

assignee_type
enum<string>

按负责人类型过滤:person 或 ai_sre。ai_sre 返回指派给 AI SRE 的事项(AI 用它查询自己的任务),不需要 assignee_id。person 与 assignee_id 一起使用时,只返回该成员负责的事项。省略本字段且 assignee_id 为正数时,按 person 过滤。

可用选项:
person,
ai_sre
cursor
string

上一次响应中的 next_cursor,内容不透明。游标无效时返回 InvalidParameter。

limit
integer<int64>
默认值:50

每页条数。0、负数或省略表示 50;大于 200 时按 200 处理。

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object

游标分页的跟进事项列表。