Skip to main content
POST
获取 ServiceDeskPlus 关联故障

限制说明

使用说明

  • 查询 ServiceDeskPlus 请求与 Flashduty 故障之间的同步映射记录,用于排查 ITSM 同步状态或定位外部请求链接。
  • 不按 incident_id 查询时,start_timeend_time 必填,均为 Unix 秒时间戳;时间范围不能超过 30 天。
  • status 仅支持 successfailed,分别表示同步成功和同步失败。
  • 响应按内部记录 ID 排序;asctrue 时升序,否则降序。继续翻页时传入上次响应的 search_after_ctx

授权

app_key
string
query
必填

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

请求体

application/json

查询 ServiceDeskPlus 请求同步记录的过滤条件。按故障 ID 查询时可不传时间窗口;否则必须传入不超过 30 天的 Unix 秒时间窗口。

start_time
integer<int64>

时间窗口起点(Unix 秒)。按 incident_id 查询时可省略。

必填范围: x >= 0
end_time
integer<int64>

时间窗口终点(Unix 秒),必须大于等于 start_time。按 incident_id 查询时可省略。

必填范围: x >= 0
status
enum<string>

同步状态过滤。

可用选项:
success,
failed
channel_ids
integer<int64>[]

协作空间 ID 列表。

integration_id
integer<int64>

ServiceDeskPlus 集成 ID。

必填范围: x >= 0
incident_id
string

Flashduty 故障 ID。提供后可不传时间窗口。

Maximum string length: 64
request_id
string

ServiceDeskPlus 请求 ID。

Maximum string length: 64
asc
boolean

true 时按内部记录 ID 升序返回;否则降序。

p
integer<int64>

页码,从 1 开始。使用 search_after_ctx 时忽略。

必填范围: x >= 0
limit
integer<int64>
默认值:20

分页大小,默认 20,最大 100。

必填范围: 0 <= x <= 100
search_after_ctx
string

上一页返回的翻页游标。

响应

成功

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

request_id
string
必填

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

示例:

"01HK8XQE3Z7JM2NTFQ5YJ8P9R4"

data
object
必填

分页的 ServiceDeskPlus 请求同步记录列表。