跳转到主要内容
Flashduty Open API 提供 392 个接口,覆盖 On-call、Monitors、RUM、AI SRE 和平台五个主要模块。所有接口使用统一认证方式和请求规范。详情参见快速开始。
所有接口 URL 均以 https://api.flashcat.cloud 为 base,用 APP Key 认证(query 参数 app_key 或请求头 Fd-App-Key,见快速入门)。

故障管理

协作空间

告警管理

公共集成

/integration/* 管理公共(账户级)集成,包含支持的 IM 和 Webhook 类型。协作空间专属集成使用 /channel/integration/*。列表和详情返回完整集成 Key,配置中已保存的密钥类值返回 ******。

专属集成

/channel/integration/* 管理协作空间专属集成。查询要求协作空间查看、协作空间管理或集成中心查看,写入要求协作空间管理。查询还要求目标空间可见,写入还要求目标空间的管理资格。共用的 /integration/type/list 类型目录也允许这三项读取权限;限制了接口范围的 App Key 须允许 integration.api:read:typeList 才能查询。App Key 的 api_scopes 须允许对应操作。私有空间仅对账户所有者、Admin、空间创建者、所属团队和管理团队成员可见;写入按空间管理权限判断。查询返回完整集成 Key,配置中的已保存密钥类值返回 ******。

集成工具

值班排班

许可管理

日历管理

通知模板

标签增强

分析看板

状态页

变更管理

IM 集成

告警规则

告警规则的导入与导出仅在控制台提供,见告警规则入门指南。

告警数据源

诊断分析

通用工具

仪表盘

规则分组

RUM 自定义字段

应用管理

RUM 问题跟踪

RUM 会话回放

RUM Sourcemap

RUM 数据查询

仪表盘

错误采集规则

Issue 预设严重性规则

资源

技能

MCP 服务器

A2A 智能体

会话

POST /safari/session/get 的响应在 events 之外还包含 pending_messages 字段:会话队列中、Agent(Actor)尚未读取的人类消息的服务端投影,按执行顺序排列(队首在前),始终为数组(没有排队消息时是空数组,不会是 null)。每个元素的字段:只包含普通人类消息:自动化、子会话通知、父会话初启消息等带 source 的消息,以及提问作答(function_response)与页面动作的批量回执(function_responses)所在的消息不在其中。内容与 user_message_enqueued 帧的载荷一致。

自动化

知识

产物

/safari/artifact/gallery/pin 与 /safari/artifact/gallery/unpin 都以 artifact_id(必填)为入参,成功时返回空响应,都不会改动产物本身。置顶是按调用者个人维护的偏好,不是对产物的编辑:产物仍对全账户可见,只有调用者自己看到的画廊顺序不同——产物列表把调用者置顶的产物排到前面,并在这些行上返回 pinned_at(Unix 毫秒,未置顶时不返回该字段)。任何账户成员都可以置顶自己看得到的产物;置顶要求产物存在(不存在返回 404),取消置顶不做存在性检查。两个接口都幂等:重复置顶会刷新置顶时间,取消一个从未置顶的产物也会成功。

成员管理

团队管理

角色与权限

审计日志

账户设置