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 でログインするか、接続画面でライセンスキーを入力してください。クライアントシークレットは不要です。
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"
}