uptimescout
获取 API 密钥

REST / MCP / SDK

UptimeScout API 文档

通过 REST、SDK 和 MCP 获取服务状态、区域信号及历史记录。构建仪表板,为 AI 助手提供清晰的可用性参考。

快速入门

curl -G https://api.uptimescout.com/v1/status \
  --data-urlencode "service=github" \
  --data-urlencode "region=US" \
  -H "Authorization: Bearer $EVELODE_LICENSE_KEY"

可用方法

GET /v1/services搜索服务目录并翻页浏览。
GET /v1/status读取单项服务当前已保存的状态。
GET /v1/statuses通过一次请求读取多项服务的状态。
GET /v1/summary汇总某个区域或所选服务的观测信号。
GET /v1/history分页读取一段时间内保存的观测记录。
GET /v1/stats计算已保存信号样本的占比,而非实际测得的运行时间。
GET /v1/incidents列出信号明显的服务;这些情况并非已确认的全球性事件。

数据说明

UptimeScout 在后台存储各地区的观测数据。每条响应都包含观测时间和数据新鲜度信息。同一服务在不同地区可能呈现不同信号。

运行正常信号表示在该条已保存的样本中未观察到明显干扰。明显干扰或中断信号描述的是观测到的情况,并不代表已确认发生全球性事件。缺失或过期的观测记录状态未知。样本占比不是实际测得的运行时间百分比,也不代表 SLA。

各地区持续采集观测数据。请查看各项服务显示的最近观测时间和数据新鲜度,判断状态信息的时效性。

语言决定信息的呈现方式;观测地区决定数据描述的是哪个国家。您可以分别切换两者。页面经过翻译,并不意味着观测数据必然来自某个特定国家。

所有服务

许可与请求限额

使用 Evelode 许可密钥作为 Bearer 令牌。请将密钥保存在服务器上,不要放入浏览器代码或公开代码仓库。只有成功的许可数据请求会计入额度。续订许可或更改套餐会启用新的额度;额度不会按自然月重置。年度套餐在整个年度许可期限内共用一个请求池。

付款、续订、套餐变更和许可证管理由 Evelode.com 处理。许可证续订或变更套餐时,请求额度会重置,不会在每个自然月初重置。年度套餐包含 12 个月的请求额度,作为一个额度池供整个许可证期限使用。历史记录从数据收集开始时累积。Free 套餐不收取周期性费用。

定价

连接 AI 助手

在助手中添加服务器 URL,选择 OAuth,然后通过 Evelode 登录或在连接页面输入许可证密钥。无需客户端密钥。

连接 UptimeScout

https://mcp.uptimescout.com
Authorization: Bearer YOUR_EVELODE_LICENSE_KEY

响应处理

读取数据前请先检查 HTTP 状态码:400 表示参数无效;401 或 403 表示身份验证或许可存在问题;409 表示请求期间许可权限发生变化;429 表示请求或速率超限;503 表示暂时无法使用。请遵循重试等待时间,避免短时间内反复重试。

已保存观测记录示例

{
  "available_regions": [
    "AE",
    "AR",
    "AT",
    "AU",
    "AZ",
    "BD",
    "BE",
    "BG",
    "BH",
    "BR",
    "CA",
    "CH",
    "CL",
    "CO",
    "CR",
    "CZ",
    "DE",
    "DK",
    "DO",
    "DZ",
    "EC",
    "EG",
    "ES",
    "FI",
    "FR",
    "GB",
    "GR",
    "GT",
    "HK",
    "HR",
    "HU",
    "ID",
    "IE",
    "IL",
    "IN",
    "IT",
    "JO",
    "JP",
    "KE",
    "KR",
    "MA",
    "MX",
    "MY",
    "NG",
    "NL",
    "NO",
    "NZ",
    "PA",
    "PE",
    "PH",
    "PK",
    "PL",
    "PR",
    "PT",
    "PY",
    "RO",
    "RS",
    "RU",
    "SA",
    "SE",
    "SG",
    "SK",
    "TH",
    "TN",
    "TR",
    "TW",
    "UA",
    "US",
    "UY",
    "VE",
    "VN",
    "ZA"
  ],
  "data_type": "availability_observations",
  "generated_at": "2026-11-18T18:55:18.714329Z",
  "region": "US",
  "service": {
    "age_seconds": 16,
    "category": "it",
    "description": "\u7528\u4e8e Git \u4ed3\u5e93\u3001\u4ee3\u7801\u534f\u4f5c\u3001\u95ee\u9898\u8ddf\u8e2a\u548c\u8f6f\u4ef6\u4ea4\u4ed8\u7684\u5e73\u53f0\u3002",
    "description_language": "zh",
    "id": "github",
    "logo_kind": "brand",
    "logo_url": "https://uptimescout.com/static/brand-assets/github.svg?v=18e8fe76f953a31c",
    "name": "GitHub",
    "observed_at": "2026-11-18T18:55:01.987427Z",
    "regions": [
      "US"
    ],
    "scope": "regional",
    "signal": "reported_availability",
    "stale": false,
    "status": "outage"
  },
  "stale_after_seconds": 600,
  "status": "ok"
}

快速查看

正在加载已保存的观测结果

信号变化趋势

每个区间显示出现频率最高的观测信号。若状态计数并列,则采用并列状态中最近一次观测的状态。选中某列可查看完整明细。