# UptimeScout API 문서

REST, SDK 및 MCP를 통해 서비스 상태, 지역별 신호와 이력을 확인하세요. 대시보드를 만들고 AI 어시스턴트에 명확한 가용성 정보를 제공할 수 있습니다.

URL: https://uptimescout.com/ko/docs/

## REST

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

## AI 어시스턴트 연결

아래 엔드포인트에 Streamable HTTP MCP 클라이언트를 연결하고 Authorization 헤더에 라이선스 키를 입력하세요. 읽기 전용 도구 7개로 서비스 상태, 지역별 신호와 이력을 확인할 수 있습니다. 동일한 라이선스 한도가 적용됩니다.

https://mcp.uptimescout.com

## 응답 처리

데이터를 읽기 전에 HTTP 상태 코드를 확인하세요. 400은 잘못된 매개변수, 401 또는 403은 인증 또는 라이선스 문제, 409는 요청 처리 중 라이선스 권한 변경, 429는 요청 한도 또는 속도 제한, 503은 일시적인 이용 불가를 의미합니다. 재시도 대기 시간을 준수하고 짧은 간격으로 반복해서 재시도하지 마세요.

OpenAPI: https://uptimescout.com/openapi.json
