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/status서비스 하나의 현재 저장 상태를 조회합니다.
GET /v1/statuses한 번의 요청으로 여러 서비스의 상태를 조회합니다.
GET /v1/summary지역 또는 선택한 서비스의 관측 신호를 요약합니다.
GET /v1/history페이지별로 저장된 시간별 관측값을 조회합니다.
GET /v1/stats측정된 가동률이 아닌 저장된 신호 표본의 비율을 계산합니다.
GET /v1/incidents신호 상승이 관측된 서비스를 나열합니다. 확인된 전 세계적 장애를 뜻하지는 않습니다.

데이터 작동 방식

UptimeScout은 지역별 관측 데이터를 백그라운드에서 저장합니다. 각 응답에는 관측 시각과 최신성 정보가 포함됩니다. 동일한 서비스라도 지역에 따라 서로 다른 신호가 나타날 수 있습니다.

정상 신호는 저장된 해당 표본에서 심각한 서비스 중단이 관측되지 않았음을 뜻합니다. 신호 상승 또는 장애 신호는 관측된 상태를 나타내며, 전 세계적인 장애가 확인되었다는 뜻은 아닙니다. 관측값이 없거나 오래된 경우 상태를 알 수 없습니다. 표본 비율은 측정된 가동률이나 SLA가 아닙니다.

인터페이스는 1분마다 새로고침됩니다. 상태가 얼마나 최신인지 확인하려면 각 서비스의 관측 시각과 최신성 정보를 확인하세요.

언어는 정보를 표시하는 방식을 결정하고, 관측 지역은 데이터가 어느 국가를 나타내는지 결정합니다. 두 항목은 각각 별도로 변경할 수 있습니다. 페이지를 번역해도 특정 국가에서 관측한 데이터가 자동으로 표시되는 것은 아닙니다.

모든 서비스

라이선스 및 요청 한도

Evelode 라이선스 키를 Bearer 토큰으로 사용하세요. 키는 서버에 보관하고 브라우저 코드나 공개 저장소에 노출하지 마세요. 라이선스가 적용된 요청이 성공한 경우에만 사용량이 차감됩니다. 라이선스를 갱신하거나 요금제를 변경하면 새 사용 한도가 적용되며, 달력 기준 월별로 초기화되지는 않습니다. 연간 요금제는 연간 라이선스 기간 전체에 사용할 수 있는 요청 풀을 제공합니다.

결제, 갱신, 요금제 변경 및 라이선스 관리는 Evelode.com에서 처리합니다. 요청 한도는 라이선스 갱신 또는 요금제 변경 시 초기화되며, 매월 초에는 초기화되지 않습니다. 연간 요금제는 12개월분의 월별 요청 한도를 라이선스 전체 기간에 사용할 수 있는 하나의 풀로 제공합니다. 기록은 데이터 수집을 시작한 시점부터 누적됩니다. 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:15.666709Z",
  "region": "US",
  "service": {
    "age_seconds": 13,
    "category": "it",
    "description": "Git \uc800\uc7a5\uc18c, \ucf54\ub4dc \ud611\uc5c5, \uc774\uc288 \uad00\ub9ac \ubc0f \uc18c\ud504\ud2b8\uc6e8\uc5b4 \ubc30\ud3ec\ub97c \uc704\ud55c \ud50c\ub7ab\ud3fc\uc785\ub2c8\ub2e4.",
    "description_language": "ko",
    "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"
}

간단히 보기

저장된 관측 데이터를 불러오는 중

시간에 따른 신호

각 구간에는 가장 자주 관측된 신호가 표시됩니다. 동률이면 동률 상태 중 가장 최근에 관측된 상태를 사용합니다. 열을 선택하면 전체 세부 내역을 확인할 수 있습니다.