jsonscraper
市场
返回期刊

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

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

编辑政策 报告错误

UptimeScout — 服务可用性监控

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

我们推出了 jsonscraper 上的 UptimeScout API。它为你的应用和 AI 助手提供外部服务的区域可用性信号,并附带历史记录、观测时间和明确的数据新鲜度标记。现已提供 REST、MCP 和六种语言的 SDK。你可以从免费方案开始。

从指定国家查看服务状况

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

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

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

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

打开观测地图

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

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

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

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

概念插图:各区域的观测结果汇总为结构化 API 响应
  1. 选择场景

    选择所需服务和受众所在的国家。

  2. 检查观测结果

    在同一响应中查看状态、时间和数据新鲜度。

  3. 使用结果

    将结果用于仪表盘、支持工作或 AI 助手。

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

一个 API,满足三类需求

查找服务

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

了解当前状况

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

查看变化

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

全部七种方法也都可通过 MCP 使用,例如 uptimescout_status 和 uptimescout_history。完整参数请参阅 OpenAPI 规范。

几分钟内发起第一个请求

选择免费方案,通过 Evelode 获取许可密钥,并将其保存在服务器的 UPTIMESCOUT_LICENSE_KEY 环境变量中。一个密钥即可用于 REST、MCP 和所有 UptimeScout SDK。

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 发布版本安装现成客户端:

python -m pip install "git+https://github.com/jsonscraper/[email protected]"
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 外,另有适用于 Node.js、PHP、Go、Java 和 .NET 的 SDK。每个代码库都提供操作说明和请求示例。

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

响应中包含哪些内容

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

GET /v1/statusJSON · RU
{
  "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 连接说明介绍了通过 Evelode 或许可密钥进行身份验证的方法。你也可以使用 jsonscraper 通用连接器。

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

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

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

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

UptimeScout
UptimeScout API服务 · 国家 · 观测时间
  • REST直接发送 HTTP 请求
  • SDK适用于应用的现成客户端
  • MCPAI 助手工具

免费起步,限制清晰明了

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

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

这些额度足以让你了解 API 并构建原型。如需持续监控,请根据配额安排请求频率;更高负载可选择 Starter、Builder、Pro 和 Scale。当前条款请查看套餐页面。

从一个依赖项开始

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

查看 UptimeScout API,免费开始 →

标签

这篇文章还没有标签。

人们

尚未列出本文的人员。

继续阅读Google Cloud推出Gemini for Healthcare,服务临床与行政流程
阅读下一篇文章

将阅读内容转化为可用的集成

探索 jsonscraper 社交数据 API、测试请求并构建下一个工作流。

查看 API