# UptimeScout API：为应用和 AI 提供服务区域可用性

https://jsonscraper.com/zh/blog/uptimescout-api-regional-monitoring-launch

Author: Michael Johnson

Published: 2026-11-19T15:24:18+00:00

Updated: 2026-11-19T15:24:18+00:00

在 jsonscraper 上推出 API：支持 REST、MCP 和六种现成 SDK。按指定国家查看外部依赖——免费开始。

![UptimeScout — 服务可用性监控](https://jsonscraper.com/assets/img/uptimescout-launch/cover-v8-zh.webp)

当外部平台停止响应时，很快就会变成你自己的问题：无法完成身份验证、集成卡住、支持请求队列不断增长。与此同时，同一项服务在不同国家的用户看来可能状况各异。在这种情况下，仅有一个笼统的“运行正常”状态并不足够。



我们推出了 [jsonscraper 上的 UptimeScout API](https://jsonscraper.com/zh/services/uptimescout-api?region=RU)。它为你的应用和 AI 助手提供外部服务的区域可用性信号，并附带历史记录、观测时间和明确的数据新鲜度标记。现已提供 REST、MCP 和六种语言的 SDK。你可以从免费方案开始。

 

## 从指定国家查看服务状况



对支持团队来说，关键问题很简单：服务在用户所在的地方运行得怎么样？UptimeScout 可以让你选择国家、获取当前信号，并将其与其他地区的观测结果进行比较。



例如，你可以分别检查 GitHub 在俄罗斯和德国的情况，然后查看可用时段内的历史记录。这能为你自己的日志补充背景信息，并帮助你决定下一步如何调查。在 2026 年 11 月 19 日经核实的 API 响应中，共有 72 个地区可用。请通过 `available_regions` 查看当前覆盖范围：不同服务的覆盖可能有所不同。



每个响应都包含观测时间 `observed_at` 和数据是否过时的标记 `stale`。描述语言与国家分别选择：你可以获取日本的观测数据，并使用中文或英语描述。总共支持 20 种描述语言。



> 区域信号有助于发现问题，但无法确定问题原因，也不能证实发生了全球性故障。调查时，请将其与自己的检查结果和服务提供商的官方状态进行对照；观测统计数据不等同于 uptime 或 SLA 测量值。

 

## 打开观测地图



选择一个国家或搜索所需服务。切换地球仪和地图视图，查看区域差异及最近观测时间。



[Interactive regional observations](https://jsonscraper.com/services/uptimescout-api#regions). Live observations are separate from the historical examples in this article.



地图展示的是已保存的数据快照，后台大约每分钟更新一次。观测时间始终可见：如果没有新数据，就不能认为当前状态已经得到确认。

 

## 将外部信号转化为有用行动



将 UptimeScout 接入团队已有的工作流程。在仪表盘中，它能为外部依赖提供背景信息；在支持工作中，它能帮助核实特定国家用户的反馈；在自动化流程中，它可以作为生成自定义报告或通知的数据源。



![概念插图：各区域的观测结果汇总为结构化 API 响应](https://jsonscraper.com/assets/img/uptimescout-launch/regions-v2.webp)



1. 01
   
   **选择场景**
   
   选择所需服务和受众所在的国家。
2. 02
   
   **检查观测结果**
   
   在同一响应中查看状态、时间和数据新鲜度。
3. 03
   
   **使用结果**
   
   将结果用于仪表盘、支持工作或 AI 助手。



如需查询多个依赖项，请使用批量请求。要比较不同国家，请分别针对每个地区发起请求。在向用户发送令人担忧的通知之前，请通过其他来源核实信号。

 

## 一个 API，满足三类需求



### 查找服务



`/v1/services` — 搜索服务目录。先从这里开始，选择所需依赖项。



### 了解当前状况



`/v1/status` 返回单项服务的信号，`/v1/statuses` 一次返回多项服务的信号，`/v1/summary` 则生成摘要。



### 查看变化



`/v1/history` 提供历史记录，`/v1/stats` 提供观测统计数据，`/v1/incidents` 提供近期升高的问题信号。



全部七种方法也都可通过 MCP 使用，例如 `uptimescout_status` 和 `uptimescout_history`。完整参数请参阅 [OpenAPI 规范](https://uptimescout.com/openapi.json)。

 

## 几分钟内发起第一个请求



选择[免费方案](https://jsonscraper.com/zh/services/uptimescout-api#pricing)，通过 Evelode 获取许可密钥，并将其保存在服务器的 `UPTIMESCOUT_LICENSE_KEY` 环境变量中。一个密钥即可用于 REST、MCP 和所有 UptimeScout SDK。



```bash
curl --get 'https://api.uptimescout.com/v1/status' \
  --header "Authorization: Bearer $UPTIMESCOUT_LICENSE_KEY" \
  --data-urlencode 'service=github' \
  --data-urlencode 'region=RU' \
  --data-urlencode 'lang=ru'
```



如果你使用 Python，可以从 GitHub 发布版本安装现成客户端：



```bash
python -m pip install "git+https://github.com/jsonscraper/uptimescout-api-python.git@0.1.3"
```



```python
import os
from uptimescout import Client

client = Client(os.environ["UPTIMESCOUT_LICENSE_KEY"], timeout=30)
response = client.status("github", region="RU", lang="ru")
service = response["service"]
print(service["status"], service["observed_at"], service["stale"])
```



除 [Python](https://github.com/jsonscraper/uptimescout-api-python) 外，另有适用于 [Node.js](https://github.com/jsonscraper/uptimescout-api-node)、[PHP](https://github.com/jsonscraper/uptimescout-api-php)、[Go](https://github.com/jsonscraper/uptimescout-api-go)、[Java](https://github.com/jsonscraper/uptimescout-api-java) 和 [.NET](https://github.com/jsonscraper/uptimescout-api-dotnet) 的 SDK。每个代码库都提供操作说明和请求示例。



处理响应时，请区分两个字段：顶层的 `status` 描述 API 请求的执行情况，而 `service.status` 表示所选服务的信号。呈现结果时，请考虑国家、观测时间和 `stale`。

 

## 响应中包含哪些内容



以下是 UptimeScout 于 2026 年 11 月 19 日针对俄罗斯的 GitHub 返回的一份真实但经过删减的响应。这只是数据结构示例，并非服务当前状态；许可证和配额消耗字段已省略。



GET /v1/statusJSON · RU



```json
{
  "status": "ok",
  "region": "RU",
  "service": {
    "id": "github",
    "name": "GitHub",
    "status": "operational",
    "stale": false,
    "observed_at": "2026-11-19T13:46:49.188257Z",
    "signal": "reported_availability",
    "scope": "regional"
  },
  "generated_at": "2026-11-19T13:48:48.782598Z",
  "stale_after_seconds": 600
}
```



**`service.status`**


所选服务的状态信号；此处为 operational。



**`region`**


观测所在国家，而非响应语言。



**`observed_at`**


观测发生的 UTC 时间。



**`stale`**


表示该观测是否已经过时。



`generated_at` 字段显示响应的生成时间。它不能取代 `observed_at`：数据可能早于响应生成时间。

 

## 同一 API，直接用于与助手对话



如果你想先不写代码，可以将 `https://mcp.uptimescout.com` 连接到兼容的 AI 客户端。[MCP 连接说明](https://mcp.uptimescout.com/connect?ui_locales=zh)介绍了通过 Evelode 或许可密钥进行身份验证的方法。你也可以使用 [jsonscraper 通用连接器](https://jsonscraper.com/zh/services/uptimescout-api#connect)。



> “检查 GitHub 在俄罗斯和德国的情况。列出各国的观测时间和数据新鲜度。如果信号不同，请解释目前已知的信息，以及接下来建议进行哪些检查。”



助手会获取 API 的结构化数据，并结合你的任务说明结果。不过，数据新鲜度和区域覆盖方面的限制依然存在。

 

## 将同一数据接入的三种方式



选择你熟悉的接口。REST 适用于直接发送 HTTP 请求，SDK 适用于应用，MCP 适用于 AI 助手。无论采用哪种方式，区域、观测时效和状态含义都保持一致。



![UptimeScout](https://jsonscraper.com/assets/img/uptimescout-launch/uptimescout-logo.svg)

**UptimeScout API**服务 · 国家 · 观测时间



- **REST**直接发送 HTTP 请求
- **SDK**适用于应用的现成客户端
- **MCP**AI 助手工具

 

## 免费起步，限制清晰明了



Free 方案提供**每个许可周期 1,000 次成功请求**、**每分钟最多 60 次请求**、**每个批次最多 5 项服务**，以及**7 天历史记录**。使用同一个许可证即可体验 REST、SDK 和 MCP。



在套餐限额内成功完成的批量请求仅消耗一次请求额度。历史记录的每个后续分页都单独计为一次调用。配额与许可周期关联，并在续期或更换套餐时重置，而不是在每月第一天重置。历史记录仅包含实际收集到观测数据的时段。



这些额度足以让你了解 API 并构建原型。如需持续监控，请根据配额安排请求频率；更高负载可选择 Starter、Builder、Pro 和 Scale。当前条款请查看[套餐页面](https://jsonscraper.com/zh/services/uptimescout-api#pricing)。

 

## 从一个依赖项开始



选择一项对产品至关重要的服务，以及受众所在的国家。查看地图，发起第一个请求，并评估区域背景信息能如何帮助团队。之后再添加历史记录、其他依赖项或自己的 AI 助手。



**[查看 UptimeScout API，免费开始 →](https://jsonscraper.com/zh/services/uptimescout-api?region=RU)**
