Skip to content

Commit 36eba3b

Browse files
author
Flashduty AI-SRE
committed
docs(api): daily audit 2026-09-30 — alert detail_url into the rendered on-call spec, RUM issue-detail team_id semantics
Two changes, both derived from the source repos at origin/main. B. on-call AlertItem / AlertInfo gain `detail_url`. fc-event structs/alert.go:74-78 — `DetailUrl string `json:"detail_url,omitempty"``, filled at read time, empty when the deployment has no console base. The consolidated specs got the field on 2026-09-29 (4b9015a) but the per-module split files — the ones Mintlify renders — never did, so POST /alert/info documented no detail_url on the docs site. A. POST /rum/issue/info documents that `team_id` is the application's current team. fc-rum cmd/server/controller/issue/info.go:221 `item.TeamID = application.TeamID` (PR #230, merge a190844, 2026-09-29). Issue rows keep the team recorded at creation (logic/transfer.go:55), which is what list and export still report.
1 parent e5b2f83 commit 36eba3b

6 files changed

Lines changed: 20 additions & 4 deletions

File tree

‎api-reference/on-call.openapi.en.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18334,6 +18334,10 @@
1833418334
},
1833518335
"description": "Attached images."
1833618336
},
18337+
"detail_url": {
18338+
"description": "Console URL of this alert (`{console}/alert/detail/{alert_id}`). Empty when the deployment has no console base configured.",
18339+
"type": "string"
18340+
},
1833718341
"data_source_name": {
1833818342
"type": "string",
1833918343
"description": "Deprecated. Use `integration_name`."
@@ -18516,6 +18520,10 @@
1851618520
},
1851718521
"description": "Images attached to the alert."
1851818522
},
18523+
"detail_url": {
18524+
"description": "Console URL of this alert (`{console}/alert/detail/{alert_id}`). Empty when the deployment has no console base configured.",
18525+
"type": "string"
18526+
},
1851918527
"data_source_name": {
1852018528
"type": "string",
1852118529
"description": "Deprecated: use `integration_name` instead.",

‎api-reference/on-call.openapi.zh.json‎

Lines changed: 8 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -18334,6 +18334,10 @@
1833418334
},
1833518335
"description": "附加图片。"
1833618336
},
18337+
"detail_url": {
18338+
"description": "这条告警的控制台页面(`{控制台}/alert/detail/{alert_id}`)。部署没有配置控制台地址时为空。",
18339+
"type": "string"
18340+
},
1833718341
"data_source_name": {
1833818342
"type": "string",
1833918343
"description": "已废弃,请使用 `integration_name`。"
@@ -18516,6 +18520,10 @@
1851618520
},
1851718521
"description": "告警附加的图片。"
1851818522
},
18523+
"detail_url": {
18524+
"description": "这条告警的控制台页面(`{控制台}/alert/detail/{alert_id}`)。部署没有配置控制台地址时为空。",
18525+
"type": "string"
18526+
},
1851918527
"data_source_name": {
1852018528
"type": "string",
1852118529
"description": "已废弃:请使用 `integration_name`。",

‎api-reference/openapi.en.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48845,7 +48845,7 @@
4884548845
"RUM/Issues"
4884648846
],
4884748847
"x-mint": {
48848-
"content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |",
48848+
"content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |\n\n## Usage\n\n- `team_id` is the owning application's **current** team; `POST /rum/issue/list` and `POST /rum/issue/export` report the team recorded when the issue was first seen, which differs once the application moves to another team.",
4884948849
"href": "/en/api-reference/rum/issues/rum-issue-read-info",
4885048850
"metadata": {
4885148851
"sidebarTitle": "Get issue detail"

‎api-reference/openapi.zh.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -48845,7 +48845,7 @@
4884548845
"RUM/RUM 问题跟踪"
4884648846
],
4884748847
"x-mint": {
48848-
"content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **1,000 次/分钟**;**50 次/秒** |\n| 权限要求 | 无 —— 持有有效的 `app_key` 即可调用 |",
48848+
"content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **1,000 次/分钟**;**50 次/秒** |\n| 权限要求 | 无 —— 持有有效的 `app_key` 即可调用 |\n\n## 使用说明\n\n- `team_id` 为所属应用**当前**的团队;`POST /rum/issue/list` 与 `POST /rum/issue/export` 返回 Issue 首次出现时记录的团队,应用转移到其他团队后两者不同。",
4884948849
"href": "/zh/api-reference/rum/issues/rum-issue-read-info",
4885048850
"metadata": {
4885148851
"sidebarTitle": "查看 Issue 详情"

‎api-reference/rum.openapi.en.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6454,7 +6454,7 @@
64546454
"RUM/Issues"
64556455
],
64566456
"x-mint": {
6457-
"content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |",
6457+
"content": "## Restrictions\n\n| Aspect | Value |\n| ------ | ----- |\n| Rate limits | **1,000 requests/minute**; **50 requests/second** per account |\n| Permissions | None — any valid `app_key` can call this operation |\n\n## Usage\n\n- `team_id` is the owning application's **current** team; `POST /rum/issue/list` and `POST /rum/issue/export` report the team recorded when the issue was first seen, which differs once the application moves to another team.",
64586458
"href": "/en/api-reference/rum/issues/rum-issue-read-info",
64596459
"metadata": {
64606460
"sidebarTitle": "Get issue detail"

‎api-reference/rum.openapi.zh.json‎

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -6454,7 +6454,7 @@
64546454
"RUM/RUM 问题跟踪"
64556455
],
64566456
"x-mint": {
6457-
"content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **1,000 次/分钟**;**50 次/秒** |\n| 权限要求 | 无 —— 持有有效的 `app_key` 即可调用 |",
6457+
"content": "## 限制说明\n\n| 项目 | 说明 |\n| ---- | ---- |\n| 速率限制 | 每个账户 **1,000 次/分钟**;**50 次/秒** |\n| 权限要求 | 无 —— 持有有效的 `app_key` 即可调用 |\n\n## 使用说明\n\n- `team_id` 为所属应用**当前**的团队;`POST /rum/issue/list` 与 `POST /rum/issue/export` 返回 Issue 首次出现时记录的团队,应用转移到其他团队后两者不同。",
64586458
"href": "/zh/api-reference/rum/issues/rum-issue-read-info",
64596459
"metadata": {
64606460
"sidebarTitle": "查看 Issue 详情"

0 commit comments

Comments
 (0)