Merge pull request #274 from flashcatcloud/codex/monit-query-data-openapi

docs(api): document structured monitor queries

Author: ysyneu

api-reference/monitors.openapi.en.json

@@ -2463,6 +2463,7 @@
                     "group": "诊断分析",
                     "icon": "stethoscope",
                     "pages": [
+                      "POST /monit/query/data",
                       "POST /monit/query/rows",
                       "POST /monit/query/diagnose",
                       "POST /monit/tools/catalog",
@@ -3813,6 +3814,7 @@
                     "group": "Diagnostics",
                     "icon": "stethoscope",
                     "pages": [
+                      "POST /monit/query/data",
                       "POST /monit/query/rows",
                       "POST /monit/query/diagnose",
                       "POST /monit/tools/catalog",

api-reference/monitors.openapi.zh.json

@@ -162,7 +162,7 @@ Integrate Flashduty through Open API and Webhooks for automation and custom deve
     Authentication, request specs, error handling
   </Card>
   <Card title="API Catalog" icon="list" href="/en/openapi/api-catalog">
-    All 336 endpoints organized by module
+    All 337 endpoints organized by module
   </Card>
   <Card title="About Pagination" icon="file-lines" href="/en/openapi/pagination">
     Traditional and cursor pagination

api-reference/openapi.en.json

@@ -184,7 +184,7 @@ Platform is the shared foundation underneath the four products above: how data g
 | **External Incident Submission** | ✅ Customers or partners can submit incidents **without logging in**, via a standalone page or API, with automatic escalation policy matching | Only supports email-to-incident, no structured form | Teams serving external customers can plug customer-reported issues directly into the handling process |
 | **Link Integration** | ✅ One-click jump to CMDB or internal systems by hostname and other labels | — | |
 | **Custom Webhooks (Outbound)** | Custom payload format, configurable retry conditions and automatic retries, signature-free verification, **full call-history tracing** (status codes, retry counts, request/response detail), subscribable by event type or source | Fixed payload format, fixed retry policy (3 retries, not configurable), no self-service call-history lookup | |
-| **Open APIs** | ✅ 336 endpoints covering On-call, Monitors, RUM, AI SRE, and platform management | ✅ | Both provide rich APIs with detailed documentation |
+| **Open APIs** | ✅ 337 endpoints covering On-call, Monitors, RUM, AI SRE, and platform management | ✅ | Both provide rich APIs with detailed documentation |
 
 <Tip>
 **Integration-on-demand commitment**: If a commercial or open-source tool you rely on isn't in our integration list yet, contact us — as long as you need it, we commit to fast turnaround support.
@@ -229,7 +229,7 @@ Before reaching the team, alerts pass through routing, filtering, and transforma
 
 | Tool | Flashduty | PagerDuty |
 | --- | --- | --- |
-| **[Open API](/en/openapi/api-catalog)** | 336 endpoints covering On-call, Monitors, RUM, AI SRE, and platform management, with bilingual docs | ✅ Full-featured REST API, mature documentation |
+| **[Open API](/en/openapi/api-catalog)** | 337 endpoints covering On-call, Monitors, RUM, AI SRE, and platform management, with bilingual docs | ✅ Full-featured REST API, mature documentation |
 | **[CLI](/en/developer/cli)** | 335 API operation commands + built-in Agent Skills, ready to hand directly to AI coding tools like Claude Code, Cursor, and Codex | No official CLI actively promoted: the community's most-used `pagerduty-cli` is an employee's personal project (officially not endorsed, and the author has announced it's archived); the official go-pagerduty library ships a limited `pd` command-line tool |
 | **SDK** | [Go SDK](/en/developer/go-sdk): a go-github-style wrapper covering 336 API operations across 39 services | PagerDuty officially maintains go-pagerduty, python-pagerduty, and other client libraries |
 | **[Terraform Provider](/en/developer/terraform)** | 12 resource types + 13 data source types, managing collaboration spaces, escalation policies, schedules, and more as IaC | ✅ Official Terraform Provider, mature ecosystem |

api-reference/openapi.zh.json

@@ -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 **336** 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 **337** 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.
 
 <Note>
 All endpoint URLs use `https://api.flashcat.cloud` as the base, authenticated via APP Key through query string.
@@ -269,7 +269,7 @@ All endpoint URLs use `https://api.flashcat.cloud` as the base, authenticated vi
 
 </Accordion>
 
-<Accordion title="Monitors (41 endpoints)">
+<Accordion title="Monitors (42 endpoints)">
 
 ### Alert rules
 
@@ -320,6 +320,7 @@ All endpoint URLs use `https://api.flashcat.cloud` as the base, authenticated vi
 
 | Method | Endpoint | Description |
 | :--- | :--- | :--- |
+| POST | [`/monit/query/data`](/en/api-reference/monitors/diagnostics/monit-read-query-data) | Query structured data |
 | POST | [`/monit/query/rows`](/en/api-reference/monitors/diagnostics/monit-read-query-rows) | Query data source rows |
 | POST | [`/monit/query/diagnose`](/en/api-reference/monitors/diagnostics/monit-read-query-diagnose) | Diagnose data source |
 | POST | [`/monit/tools/catalog`](/en/api-reference/monitors/diagnostics/monit-read-tools-catalog) | List target tool catalog |

docs.json

@@ -163,7 +163,7 @@ AI SRE 已全量开放**公测**，无需申请，登录控制台即可使用，
     认证方式、请求规范、错误处理
   </Card>
   <Card title="API 总览" icon="list" href="/zh/openapi/api-catalog">
-    全部 336 个接口，按模块分类
+    全部 337 个接口，按模块分类
   </Card>
   <Card title="关于分页" icon="file-lines" href="/zh/openapi/pagination">
     传统分页与游标分页机制

en/home.mdx

@@ -184,7 +184,7 @@ PagerDuty AIOps 在超大规模事件关联场景上打磨多年，能力成熟
 | **外部故障提交** | ✅ 客户或合作伙伴**免登录**通过独立页面或 API 提交故障，自动匹配分派策略 | 仅支持邮件转 incident，无结构化表单 | 对外提供服务的团队可直接把客户报障接入处置流程 |
 | **Link 集成** | ✅ 按 hostname 等标签一键跳转 CMDB 或内部系统 | — | |
 | **自定义 Webhook（出站）** | 自定义 Payload 格式、重试条件与自动重试、免密验证，**完整调用历史追溯**（状态码、重试次数、请求响应详情），可按事件类型或来源订阅 | Payload 格式固定，重试策略固定（3 次不可配置），无自助调用历史查询 | |
-| **Open APIs** | ✅ 336 个接口，覆盖 On-call、Monitors、RUM、AI SRE 与平台管理 | ✅ | 两者均提供丰富的 API 和详细文档 |
+| **Open APIs** | ✅ 337 个接口，覆盖 On-call、Monitors、RUM、AI SRE 与平台管理 | ✅ | 两者均提供丰富的 API 和详细文档 |
 
 <Tip>
 **集成按需支持承诺**：如果您常用的商业软件或开源服务尚未在集成列表中，请联系我们——只要您需要，我们承诺快速支持。
@@ -229,7 +229,7 @@ PagerDuty AIOps 在超大规模事件关联场景上打磨多年，能力成熟
 
 | 工具 | Flashduty | PagerDuty |
 | --- | --- | --- |
-| **[Open API](/zh/openapi/api-catalog)** | 336 个接口，覆盖 On-call、Monitors、RUM、AI SRE 与平台管理，双语文档 | ✅ REST API 完善，文档成熟 |
+| **[Open API](/zh/openapi/api-catalog)** | 337 个接口，覆盖 On-call、Monitors、RUM、AI SRE 与平台管理，双语文档 | ✅ REST API 完善，文档成熟 |
 | **[CLI](/zh/developer/cli)** | 335 个 API 操作命令 + 内置 Agent Skills，可直接配给 Claude Code、Cursor、Codex 等 AI 编程工具 | 无官方力推的完整 CLI：社区最常用的 `pagerduty-cli` 为员工个人项目（官方声明不背书、作者已宣布归档），官方 go-pagerduty 库附带功能有限的 `pd` 命令行小工具 |
 | **SDK** | [Go SDK](/zh/developer/go-sdk)：go-github 风格封装，覆盖 336 个 API 操作、39 个服务 | 官方维护 go-pagerduty、python-pagerduty 等客户端库 |
 | **[Terraform Provider](/zh/developer/terraform)** | 12 类资源 + 13 类数据源，IaC 管理协作空间、分派策略、值班表等 | ✅ 官方 Terraform Provider，生态成熟 |