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 登录或在连接页面输入许可证密钥。无需客户端密钥。
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"
}