Skip to main content
POST
查询跟进事项列表

授权

app_key
string
query
必填

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

请求体

application/json

查询跟进事项的过滤条件。incident_id、post_mortem_id、assignee_id 至少提供一个。

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。

limit
integer<int64>
默认值:50

每页条数,最多 200,默认 50。

必填范围: 0 <= x <= 200

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
必填

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