jsonscraper
市場
ジャーナルに戻る

UptimeScout API:アプリとAIのための地域別サービス可用性

jsonscraperのAPIを公開。REST、MCP、すぐに使える6種類のSDKを提供します。必要な国から外部依存サービスを確認。無料で始められます。

編集方針 誤りを報告する

UptimeScout — サービスの稼働状況を監視

外部プラットフォームが応答しなくなると、すぐに自社の問題になります。認証が通らない、連携が止まる、サポートへの問い合わせが増える。しかも、同じサービスでも国によってユーザーからの見え方は異なる場合があります。そんな状況では、「すべて正常」という全体ステータスだけでは不十分です。

jsonscraperのUptimeScout APIを公開します。このAPIは、外部サービスの地域別可用性シグナルを、履歴、観測時刻、データの鮮度を明示した形でアプリやAIアシスタントに提供します。REST、MCP、6言語のSDKを利用できます。無料プランから始められます。

必要な国からサービスを確認

サポートチームにとって重要なのは、ユーザーがいる場所でサービスに何が起きているか、というシンプルな問いです。UptimeScoutでは国を選び、現在のシグナルを取得し、ほかの地域の観測結果と比較できます。

たとえば、ロシアとドイツのGitHubを確認し、利用可能な期間の履歴を開くことができます。自社のログに状況の文脈を加え、次の調査手順を選ぶ助けになります。2026年11月19日に確認されたAPIレスポンスでは、72の地域が利用可能でした。現在の対象地域はavailable_regionsで確認してください。対応範囲はサービスによって異なる場合があります。

各レスポンスには観測時刻observed_atと、データが古くなっているかを示すstaleが含まれます。説明の言語は国とは別に選択できます。たとえば、日本の観測結果をロシア語または英語で取得できます。説明言語は合計20言語に対応しています。

地域別シグナルは問題の発見に役立ちますが、原因を特定するものでも、全世界的な障害を確証するものでもありません。調査では自社のチェック結果やプロバイダーの公式ステータスと照合してください。観測統計はuptimeやSLAの測定値ではありません。

観測マップを開く

国を選択するか、必要なサービスを検索してください。地球儀と地図を切り替えて、地域差や直近の観測時刻を確認できます。

マップには保存済みのデータスナップショットが表示され、バックグラウンドで約1分ごとに更新されます。観測時刻は常に表示されます。新しいデータがない場合、その状態は確認済みとはみなせません。

外部シグナルを有用なアクションにつなげる

チームがすでに使っているワークフローにUptimeScoutを加えましょう。ダッシュボードでは外部依存関係の状況を把握できます。サポートでは、特定の国からの問い合わせを調べるのに役立ちます。自動化では、自社レポートや通知のデータソースとして活用できます。

概念図:地域ごとの観測結果がまとまり、構造化されたAPI応答になる
連携に地域情報を活用。実際の測定値ではなく、概念図です。
  1. 確認する条件を選ぶ

    対象サービスとユーザーのいる国を指定します。

  2. 観測結果を確認する

    ステータス、時刻、データの鮮度を1つのレスポンスで確認します。

  3. 結果を活用する

    ダッシュボード、サポート、AIアシスタントで利用します。

複数の依存サービスには一括リクエストを使います。国ごとの比較には、地域ごとに個別のリクエストを実行してください。ユーザーに警告を送る前に、ほかの情報源でもシグナルを確認しましょう。

3つの用途を1つのAPIで

サービスを探す

/v1/services — カタログを検索します。必要な依存サービスを選ぶところから始められます。

現在の状況を把握する

/v1/statusは単一サービスのシグナルを、/v1/statusesは複数サービスのシグナルを返し、/v1/summaryは概要をまとめます。

変化を確認する

/v1/historyは履歴、/v1/statsは観測統計、/v1/incidentsは最近の問題を示す強いシグナルを返します。

7つのメソッドはすべてMCPからも利用できます。たとえば、uptimescout_statusやuptimescout_historyです。全パラメーターはOpenAPI仕様に記載されています。

数分で最初のリクエストを実行

無料プランを選び、Evelodeからライセンスキーを取得して、サーバー上のUPTIMESCOUT_LICENSE_KEYに保存します。1つのキーで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も利用できます。各リポジトリに手順とリクエスト例があります。

レスポンスを処理する際は、2つのフィールドを区別してください。トップレベルのstatusはAPIリクエストの実行状態を表し、service.statusは選択したサービスのシグナルを表します。結果を示す際は、国、観測時刻、staleを考慮してください。

応答に含まれる内容

以下は、2026年11月19日にロシアからGitHubを対象に取得した、UptimeScoutの実際の応答を簡略化したものです。データ構造の例であり、サービスの現在の状態を示すものではありません。ライセンスとクォータ消費量のフィールドは省略しています。

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をアシスタントとの対話で

自分でコードを書く前に試したい場合は、互換性のあるAIクライアントにhttps://mcp.uptimescout.comを接続してください。MCPの手順では、Evelodeまたはライセンスキーによる認証方法を説明しています。jsonscraper共通コネクターも利用できます。

「ロシアとドイツでGitHubを確認して。各国の観測時刻とデータの鮮度を示して。シグナルが異なる場合は、判明していることと、次に行うべき確認を説明して。」

アシスタントはAPIの構造化データを受け取り、タスクの文脈に沿って結果を説明できます。ただし、データの鮮度や地域カバレッジの制限は変わりません。

同じデータを連携する3つの方法

使い慣れたインターフェースを選びましょう。RESTは直接HTTPリクエストを送る場合、SDKはアプリケーションで使う場合、MCPはAIアシスタントで使う場合に適しています。どの方法でも、地域、観測データの鮮度、ステータスの意味は同じです。

UptimeScout
UptimeScout APIサービス · 国 · 観測時刻
  • REST直接HTTPリクエスト
  • SDKアプリケーション用のクライアント
  • MCPAIアシスタント用のツール

わかりやすい上限で無料スタート

Freeプランでは、ライセンス期間あたり成功リクエスト1,000件、毎分最大60リクエスト、一括リクエストあたり最大5サービス、7日間の履歴を利用できます。1つのライセンスでREST、SDK、MCPをお試しいただけます。

プラン上限内の一括リクエストの成功は、1リクエストとして消費されます。履歴の次のページを取得するたびに、個別の呼び出しとしてカウントされます。クォータはライセンス期間に紐づいており、毎月1日ではなく、更新またはプラン変更時にリセットされます。履歴には、実際に観測を収集した期間だけが含まれます。

APIを試してプロトタイプを作るには十分な内容です。継続的なモニタリングを行う場合は、リクエスト頻度をクォータに合わせてください。より大きな負荷向けにはStarter、Builder、Pro、Scaleがあります。最新の条件は料金プランページで確認できます。

まずは1つの依存サービスから

プロダクトにとって重要なサービスと、ユーザーがいる国を選びましょう。マップを確認して最初のリクエストを実行し、地域の文脈がチームにどう役立つかを確かめてください。その後、履歴やほかの依存サービス、自社のAIアシスタントを追加できます。

UptimeScout APIを開いて無料で始める →

タグ

この記事にはまだタグがありません。

人々

この記事にはまだ人物がリストされていません。

読み続けてくださいGoogle Cloud、臨床・事務業務向けGemini for Healthcareを発表
次の記事を読む

読んだ内容を実用的な連携へ

jsonscraperのソーシャルデータAPIを調べ、リクエストを試し、次のワークフローを構築しましょう。

APIを探す