From 2eef86d3885d34fb49e7cd99f2b43845c7551470 Mon Sep 17 00:00:00 2001 From: ysyneu Date: Wed, 24 Jun 2026 21:00:24 +0800 Subject: [PATCH] docs(api-catalog): add the Sessions section to the AI SRE catalog MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The API catalog (the hand-maintained master index) listed the AI SRE skill / MCP / A2A operations but had no Sessions section — the session endpoints were never added when they were adopted into the spec, the same gap that left them out of the API-reference nav (#100). Add a Sessions section (en + zh) listing the four public session operations — list / get / export / delete — and bump the AI SRE count 22 → 26 and the total 236 → 240. (cancel was dropped in #101: it is now auth=service / internal.) --- en/openapi/api-catalog.mdx | 13 +++++++++++-- zh/openapi/api-catalog.mdx | 13 +++++++++++-- 2 files changed, 22 insertions(+), 4 deletions(-) diff --git a/en/openapi/api-catalog.mdx b/en/openapi/api-catalog.mdx index ec05926..81ed779 100644 --- a/en/openapi/api-catalog.mdx +++ b/en/openapi/api-catalog.mdx @@ -3,7 +3,7 @@ title: "API Catalog" description: "Complete list of Flashduty Open API endpoints, organized by product module with links to detailed documentation" --- -Flashduty Open API provides **236** endpoints covering five major modules: On-call, Monitors, RUM, AI SRE, and Platform. All endpoints use unified authentication and request specifications. See [Quick Start](/en/openapi/introduction) for details. +Flashduty Open API provides **240** endpoints covering five major modules: On-call, Monitors, RUM, AI SRE, and Platform. All endpoints use unified authentication and request specifications. See [Quick Start](/en/openapi/introduction) for details. All endpoint URLs use `https://api.flashcat.cloud` as the base, authenticated via APP Key through query string. @@ -288,7 +288,16 @@ All endpoint URLs use `https://api.flashcat.cloud` as the base, authenticated vi - + + +### Sessions + +| Method | Endpoint | Description | +| :--- | :--- | :--- | +| POST | [`/safari/session/list`](/en/api-reference/ai-sre/sessions/session-read-list) | List sessions | +| POST | [`/safari/session/get`](/en/api-reference/ai-sre/sessions/session-read-info) | Get session detail | +| POST | [`/safari/session/export`](/en/api-reference/ai-sre/sessions/session-read-export) | Export session events | +| POST | [`/safari/session/delete`](/en/api-reference/ai-sre/sessions/session-write-delete) | Delete session | ### Skills diff --git a/zh/openapi/api-catalog.mdx b/zh/openapi/api-catalog.mdx index 7aedab8..ce56d61 100644 --- a/zh/openapi/api-catalog.mdx +++ b/zh/openapi/api-catalog.mdx @@ -3,7 +3,7 @@ title: "API 总览" description: "Flashduty Open API 全量接口列表，按产品模块分类，点击可跳转到接口详情" --- -Flashduty Open API 共提供 **236** 个接口，覆盖 On-call、Monitors、RUM、AI SRE 和平台五大模块。所有接口使用统一的认证方式和请求规范，详见[快速入门](/zh/openapi/introduction)。 +Flashduty Open API 共提供 **240** 个接口，覆盖 On-call、Monitors、RUM、AI SRE 和平台五大模块。所有接口使用统一的认证方式和请求规范，详见[快速入门](/zh/openapi/introduction)。 所有接口 Endpoint 均为 `https://api.flashcat.cloud`，使用 APP Key 通过 query string 认证。 @@ -288,7 +288,16 @@ Flashduty Open API 共提供 **236** 个接口，覆盖 On-call、Monitors、RUM - + + +### 会话 + +| 方法 | 接口 | 描述 | +| :--- | :--- | :--- | +| POST | [`/safari/session/list`](/zh/api-reference/ai-sre/sessions/session-read-list) | 查询会话列表 | +| POST | [`/safari/session/get`](/zh/api-reference/ai-sre/sessions/session-read-info) | 查看会话详情 | +| POST | [`/safari/session/export`](/zh/api-reference/ai-sre/sessions/session-read-export) | 导出会话事件 | +| POST | [`/safari/session/delete`](/zh/api-reference/ai-sre/sessions/session-write-delete) | 删除会话 | ### 技能