故障列表-卡片视图

curl --location --request POST 'https://api.flashcat.cloud/incident/list-by-card?app_key' \ --header 'Content-Type: application/json' \ --data-raw '{ "view_id": "string", "asc": true, "progress": "string", "title": "string", "channel_ids": [ 0 ], "responder_ids": [ 0 ], "acker_ids": [ 0 ], "creator_ids": [ 0 ], "incident_ids": [ "string" ], "start_time": 0, "end_time": 0, "range_by": "string", "incident_severity": "Critical", "is_related": true, "is_snoozed": true, "is_my_team": true, "labels": { "$key": [ "string" ] } }'

{ "error": { "code": "InvalidParameter", "message": "string" }, "data": { "items": [ { "title": "string", "total": 0, "incident_severity": "string", "incident_ids": [ "string" ] } ] } }

请求参数

Authorization

在 query 添加参数

app_key

示例：

app_key: ********************

Body 参数application/json

view_id

string

视图ID

必需

asc

boolean

是否升序

可选

progress

string

处理状态

可选

全部（progress不传）未关闭（progress传Triggered,Processing）待处理（progress传Triggered）处理中（progress传Processing）已关闭（progress传Closed）

title

string

标题

可选

channel_ids

array[integer]

协作空间ID列表

可选

0代表全局故障

responder_ids

array[integer]

处理人ID列表

可选

处理人可能包含未认领的已分派人员

acker_ids

array[integer]

认领人ID列表

可选

creator_ids

array[integer]

创建人ID列表

可选

0代表系统聚合故障

incident_ids

array[string]

故障ID列表

可选

start_time

integer

检索区间起点

必需

单位秒，end_time-start_time不能超过1个月

end_time

integer

检索区间终点

必需

单位秒，end_time-start_time不能超过1个月

range_by

string

检索时间字段

可选

默认为last_time，支持updated_at last_time start_time。但如果by_intersection=true，range_by只能为last_time或end_time

incident_severity

enum<string>

严重程度

可选

Critical,Info,Warning 可以传多个，逗号分隔

枚举值:

CriticalWarningInfo

is_related

boolean

是否与我相关

可选

登录人为发起人、被指派、关闭人或处理人之一

is_snoozed

boolean

是否暂缓中

可选

仅看当前状态，与查询时间区间无关

is_my_team

boolean

我团队的

可选

当设置为true，仅统计我所在团队下属协作空间内的故障

labels

object

标签筛选

可选

支持精确匹配、正则匹配和通配匹配。以'/'作为前后缀的字符串将被识别为正则。举例：指定('datacenter' IN ['bj01','sh-*','']) AND ('host' IN '/api-server-\d+/')，可匹配到产生于'bj01'和'sh-01'、'sh-02'三个数据中心并且主机名满足'api-server-\d+'正则的报警事件

$key

array[string]

标签key，值为可选values，一个匹配即匹配

必需

示例

返回响应

🟢200成功

application/json

Body

error

object (DutyError)

可选

code

enum<string>

错误码

必需

枚举值:

InvalidParameterInvalidContentTypeUnauthorizedAccessDeniedMethodNotAllowedRequestTooFrequentlyRequestVerifyRequiredDangerousOperationRequestLockedRouteNotFoundBalanceNotEnoughUndonedOrderExistResourceNotFoundInternalErrorReferenceExist

message

string

错误描述

必需

data

object

可选

items

array [object {4}]

必需

请注意，匹配超过100条数时，仅返回100条