List the project's monitors, with 24-hour uptime, average latency and a latency sparkline.列出当前项目的监控项，附带 24 小时可用率、平均延迟和延迟走势。

[{ id, name, type, target, method, expectedStatus, intervalSec, timeoutMs, failureThreshold, regions,
   status, consecutiveFailures, lastCheckedAt, nextCheckAt, paused, heartbeatToken, keyword, keywordMode,
   headers, graceSec, ..., uptime24h, avgLatency24h, spark }]

Create a monitor. Omitted fields take their defaults. Returns 201 with the monitor; heartbeat monitors get a heartbeatToken.创建监控项，省略的字段使用默认值。返回 201 和监控项；心跳类型会生成 heartbeatToken。

name           string, 1-120 chars (required)
type           "http" | "tcp" | "dns" | "heartbeat" | "postgres" | "mysql" | "redis"   (default "http"; cannot be changed later)
target         string, max 2048   (URL for http, host:port for tcp/postgres/mysql/redis, hostname for dns)
method         "GET" | "HEAD" | "POST"                       (default "GET")
expectedStatus integer 100-599                               (default 200)
intervalSec    integer 60-86400                              (default 60)
timeoutMs      integer 1000-30000                            (default 10000)
failureThreshold integer 1-10  consecutive failures before an incident opens (default 3)
regions        string[]                                      (default ["auto"])
keyword        string | null, max 500                        (default null)
keywordMode    "contains" | "absent"                         (default "contains")
headers        { [name: string]: string }                    (default {})
graceSec       integer 0-86400, heartbeat grace period       (default 0)
channelIds     uuid[], max 50                                (default [])
tags           string[], max 20 items of up to 32 chars      (default [])
slowThresholdMs integer 100-60000, latency above this marks the monitor "degraded" (default 1500)
slowAlertAfter integer 0-20, open a latency incident after this many consecutive slow checks; 0 = never (default 0)

Download the project's monitors as JSON ({ version, exportedAt, monitors }). Request headers are included, so treat the file as sensitive.以 JSON 导出当前项目的监控项（{ version, exportedAt, monitors }）。文件包含请求头，请当作敏感文件保管。

Create monitors from a JSON array (or an object with a monitors array), up to 500 per call. Accepts our export plus common aliases from other tools (name/friendly_name, target/url/hostname, interval in seconds, type https/keyword/port). Invalid items are skipped and reported; returns 201 { created, skipped: [{ index, name, error }] }, or 400 when nothing was created.从 JSON 数组（或含 monitors 数组的对象）批量创建监控项，单次最多 500 个。支持本产品的导出格式，以及其他工具常见的字段别名（name/friendly_name、target/url/hostname、interval 秒、type https/keyword/port）。无效项会被跳过并返回；成功时 201 { created, skipped: [{ index, name, error }] }，一个都没创建时 400。

{ "monitors": [ { "name": "API", "type": "http", "target": "https://api.example.com", "tags": ["prod"] } ] }

{ created: 1, skipped: [] }

One monitor with its last 120 check results, last 5 incidents and stats.获取单个监控项，含最近 120 条检测结果、最近 5 个事件和统计数据。

{ ...monitor, results: [{ id, region, ok, statusCode, latencyMs, error, checkedAt }],
  incidents: [...], stats: { uptime24h, uptime7d, avg24h, p95 } }

Update the named fields only (same fields as create, except type). Also accepts paused (boolean) to pause or resume. At least one field is required.仅更新传入的字段（与创建相同，但不含 type），另可传 paused（布尔）暂停或恢复。至少需要一个字段。

any of the create fields except "type", plus:
paused  boolean

Delete a monitor and its results. Returns 204.删除监控项及其检测结果。返回 204。

Run a check immediately. Returns { ok: true }.立即执行一次检测。返回 { ok: true }。

The latest 100 incidents of the project (plus workspace-level incidents not tied to a monitor), newest first.当前项目最新的 100 个事件（含未关联监控项的工作区级事件），按时间倒序。

[{ id, monitorId, title, status, severity, auto, assigneeId, startedAt, acknowledgedAt, resolvedAt, monitorName }]

Open an incident manually. Returns 201.手动创建事件。返回 201。

title      string, 1-200 (required)
body       string, max 4000   first update, optional
severity   "minor" | "major"   (default "major")
monitorId  uuid | null        optional

An incident with its updates, monitor, assignee and up to 8 failing checks.获取事件详情，含更新记录、监控项、负责人和最多 8 条失败检测。

{ ...incident, updates: [{ id, status, body, authorId, createdAt }], monitor, assignee, checks }

Post an update and set the incident status. Subscribers and alert channels are notified. Status "resolved" closes the incident. Returns 201.发布更新并设置事件状态，并通知订阅者和告警渠道。状态为 "resolved" 时事件关闭。返回 201。

status  "investigating" | "identified" | "monitoring" | "resolved"
body    string, 1-4000

Acknowledge an incident and assign it to the caller. Returns the incident.确认事件并指派给调用者。返回该事件。

List the alert channels available in the project: workspace-wide ones (projectId null) and the project's own.列出当前项目可用的告警渠道：工作区级渠道（projectId 为 null）和项目自己的渠道。

[{ id, type, name, config, enabled, autoEnable, createdAt, projectId }]

Create a channel. Returns 201.创建渠道。返回 201。

type     "email" | "slack" | "telegram" | "webhook" | "pagerduty" | "lark"
name     string, 1-80
config   object   (default {})
enabled  boolean  (default true)
autoEnable  boolean  (default false)  new monitors start out alerting this channel
scope    "workspace" | "project"  (default "workspace"; a project-limited key always creates a project channel)

Update name, enabled, autoEnable or config.更新名称、启用状态、autoEnable 或配置。

name     string, 1-80
enabled  boolean
autoEnable  boolean
config   object

Send a test message. Returns { ok: true }, or 502 with the delivery error.发送测试消息。成功返回 { ok: true }，失败返回 502 及错误信息。

Delete a channel. Returns 204, or 409 (code "channel_in_use", with the monitors) while a monitor still lists it in channelIds.删除渠道。返回 204；仍有监控在 channelIds 中选用它时返回 409（code 为 "channel_in_use"，并附监控列表）。

List the project's status pages.列出当前项目的状态页。

[{ id, slug, title, theme, showLatency, customDomain, externalUrl, createdAt, projectId }]

Create a status page. The slug must be unused (409 otherwise). Returns 201.创建状态页。slug 不能被占用（否则 409）。返回 201。

slug         string, /^[a-z0-9-]{3,40}$/ (required)
title        string, 1-120 (required)
externalUrl  string | null, http(s) URL up to 2048 (a link shown beside the title, rel=nofollow)
theme        "light" | "dark" | "auto"
showLatency  boolean
monitorIds   uuid[]
components   [{ monitorId: uuid, groupName?: string 1-60 }], max 200 (takes precedence over monitorIds)

A status page with its ordered components.获取状态页及其有序组件。

{ ...page, monitorIds: uuid[], components: [{ monitorId, groupName }] }

Update title, theme, showLatency or replace the components. Slug cannot be changed. Returns { ok: true }.更新标题、主题、延迟显示，或替换组件。slug 不可修改。返回 { ok: true }。

title, theme, showLatency, externalUrl, monitorIds, components   (all optional, as in create)

Delete a status page. Returns 204.删除状态页。返回 204。

Up to 1000 subscribers, newest first.最多 1000 位订阅者，按时间倒序。

[{ id, email, confirmedAt, createdAt }]

Remove a subscriber. Returns 204.移除订阅者。返回 204。

The project's latest 200 windows, by start time descending.当前项目最新的 200 个维护窗口，按开始时间倒序。

[{ id, name, startsAt, endsAt, monitorIds, createdAt, projectId }]

Schedule a window. Returns 201.创建维护窗口。返回 201。

name        string, 1-120
startsAt    ISO 8601 date-time
endsAt      ISO 8601 date-time, after startsAt
monitorIds  uuid[], max 500   (default [])

Delete a window. Returns 204.删除维护窗口。返回 204。

The workspace's projects (only the permitted ones for a limited key).列出工作区的项目（受限密钥只能看到被授权的项目）。

[{ id, name, createdAt }]

Create a project. Returns 201.创建项目。返回 201。

name  string, 1-60

Rename a project.重命名项目。

name  string, 1-60

Delete a project and everything in it. A workspace must keep at least one project (400). Returns 204.删除项目及其全部内容。工作区至少保留一个项目（否则 400）。返回 204。

Workspace preferences.工作区偏好设置。

{ alertLogRetentionDays: 30, checkRetentionDays: 90 }

Update preferences. Not available to project-limited keys (403).更新偏好设置。受限于项目的密钥不可用（403）。

alertLogRetentionDays  integer 1-365
checkRetentionDays     integer 1-365   (raw check results; hourly rollups are kept for a year)

Alert delivery history, newest first. Query: limit (1-200, default 50) and before (ISO 8601 date-time cursor, the createdAt of the last row of the previous page).告警投递历史，按时间倒序。查询参数：limit（1-200，默认 50）和 before（ISO 8601 时间游标，取上一页最后一条的 createdAt）。

[{ id, channelId, channelName, channelType, kind, incidentId, monitorName, ok, error, createdAt }]
kind: "incident.opened" | "incident.resolved" | "test" | "subscribers"

The caller, the workspace and the active project.当前调用者、工作区和当前项目。

{ userId, user: { name, email, locale }, organization, projectId }

Download everything held about the caller as JSON: profile, sessions and the workspaces they own or administer.以 JSON 下载与调用者相关的全部数据：资料、会话，以及其拥有或管理的工作区内容。

Set the language used for emails to this user.设置发给该用户的邮件所使用的语言。

locale  "en" | "zh-CN"

{ locale }

Sidebar counts for the active project.当前项目的侧边栏计数。

{ monitors, incidents, "status-pages", alerting }