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/status1つのサービスの現在保存されている状況を取得します。
GET /v1/statuses複数サービスの状況を1回のリクエストで取得します。
GET /v1/summary地域または選択したサービスの観測シグナルを要約します。
GET /v1/history保存された経時的な観測データをページごとに取得します。
GET /v1/stats実測稼働率ではなく、保存されたシグナルサンプルの比率を算出します。
GET /v1/incidents注意シグナルがあるサービスを一覧表示します。世界規模のインシデントが確認されたことを示すものではありません。

データの仕組み

UptimeScoutは、バックグラウンドで地域ごとの観測データを保存します。各応答には観測時刻とデータの鮮度に関する情報が含まれます。同じサービスでも、地域によって異なるシグナルが得られる場合があります。

正常シグナルは、保存されたサンプルで問題を示すシグナルが観測されなかったことを示します。注意シグナルまたは障害シグナルは観測された状況を示すもので、世界規模のインシデントが確認されたことを意味しません。観測データがない場合や古い場合は、不明として扱われます。サンプルの比率は、実測稼働率や SLA ではありません。

画面は毎分更新されます。状況がどれだけ最新かを判断するには、各サービスの観測時刻とデータの鮮度をご確認ください。

言語は情報の表示方法を決め、観測地域はデータがどの国を対象としているかを決めます。両者は個別に切り替えられます。ページを翻訳しても、特定の国の観測結果が自動的に表示されるわけではありません。

すべてのサービス

ライセンスとリクエスト上限

Evelode ライセンスキーを Bearer トークンとして使用してください。キーはサーバー上で管理し、ブラウザーのコードや公開リポジトリには含めないでください。データ取得に成功したリクエストのみ、利用枠を消費します。ライセンスの更新またはプランの変更で、新しい利用枠が開始されます。暦月ごとのリセットはありません。年間プランでは、月間プラン1期間分の12倍のリクエスト枠を、年間ライセンス期間全体で1つの枠として利用します。

お支払い、更新、プラン変更、ライセンス管理はEvelode.comで行います。リクエスト枠は、ライセンスの更新時またはプラン変更時にリセットされます。暦月の初めにはリセットされません。年額プランでは、12か月分のリクエスト枠をライセンス期間全体で1つの枠として利用できます。履歴は収集開始時から蓄積されます。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:17.337185Z",
  "region": "US",
  "service": {
    "age_seconds": 15,
    "category": "it",
    "description": "Git\u30ea\u30dd\u30b8\u30c8\u30ea\u3001\u30b3\u30fc\u30c9\u306e\u5171\u540c\u4f5c\u696d\u3001\u8ab2\u984c\u7ba1\u7406\u3001\u30bd\u30d5\u30c8\u30a6\u30a7\u30a2\u306e\u63d0\u4f9b\u3092\u652f\u3048\u308b\u30d7\u30e9\u30c3\u30c8\u30d5\u30a9\u30fc\u30e0\u3002",
    "description_language": "ja",
    "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"
}

概要を見る

保存済みの観測結果を読み込み中

状況の推移

各区間は、最も多く観測されたシグナルを示します。同数の場合は、同数の状態のうち最新のものが使われます。列を選択すると詳細を確認できます。