# UptimeScout로 서비스 가용성 API 연동하기



URL: https://uptimescout.com/ko/blog/availability-api-integration/



모든 응답을 색상 점 하나로 줄이지 말고 타임스탬프와 불확실성을 표시하는 가용성 패널을 만들어 보세요.



## 폴링 전에 서비스 ID 찾기



먼저 services 엔드포인트에서 UptimeScout가 사용하는 식별자를 찾으세요. 사람이 읽는 브랜드 이름이 항상 API 식별자와 일치하는 것은 아닙니다. 상태 및 기록 요청에서 같은 대상을 가리키도록 ID와 지역을 애플리케이션 설정에 저장하세요.

Evelode에서 사용 가능한 라이선스를 구매하고 서버 측 비밀 정보 또는 환경 변수에 보관하세요. 유료 키를 브라우저 JavaScript, 공개 저장소, 스크린샷, URL에 삽입하지 마세요.



## 인증된 상태 요청 보내기



예시를 실행하기 전에 자체 환경에서 EVELODE_LICENSE_KEY를 설정하세요. 이 예시는 US 지역의 GitHub 관측 정보를 요청하는 템플릿이며, GitHub의 현재 상태를 주장하는 내용은 아닙니다.



```sh

curl -G https://api.uptimescout.com/v1/status \
  --data-urlencode "service=github" \
  --data-urlencode "region=US" \
  -H "Authorization: Bearer $EVELODE_LICENSE_KEY"

```



## 표시하기 전에 응답 해석하기



전송 요청이 성공했는지와 서비스 가용성 신호는 별개의 계층입니다. 먼저 HTTP 상태와 응답 구조를 검증하세요. 그런 다음 service.status, service.observed_at, service.stale을 확인하세요. unknown과 stale을 operational로 조용히 처리하지 말고 그대로 표시하세요.

관측 시각과 함께 지역을 저장하세요. 자체 인터페이스가 1분마다 새로고침되더라도 응답을 가져온 시각과 관측 시각을 구분해 표시하세요. 최신 HTTP 응답이더라도 그 안에 더 오래된 관측 정보가 담겨 있을 수 있습니다.



## 요청량 계획 및 한도 처리



작업 방식에 맞는 경우 statuses를 사용하고, 선택한 요금제에서 최대 일괄 처리 크기를 확인하세요. 요청 허용량과 분당 요청 수는 서로 다른 한도입니다. REST, SDK, MCP 요청은 모두 동일한 라이선스 요청 한도에서 차감됩니다.

HTTP 429를 받으면 Retry-After를 준수하고 즉시 요청을 몰아서 재시도하지 마세요. 일시적 오류에는 횟수를 제한하고 대기 시간을 늘려 재시도하세요. 인증 또는 잘못된 매개변수 오류를 무한히 재시도하지 마세요. 갱신 및 요금제 변경 시 라이선스 허용량이 업데이트되며, 매월 1일에 초기화되지는 않습니다.



## 배포 전에 불확실한 경우 테스트하기



정상적으로 알려진 서비스, 알 수 없는 ID, 키 누락, 잘못된 매개변수, 오래되었거나 누락된 관측 정보를 테스트하세요. 이러한 경우에 인터페이스에서 유용한 메시지가 표시되는지 확인하세요. 인증 정보나 계정 정보가 포함된 전체 진단 결과는 공개 로그에 남기지 마세요.

API 문서에는 공개 메서드 7개와 OpenAPI 스키마가 있습니다. jsonscraper에서 Python, Node.js, PHP, Go, Java, .NET SDK 링크를 제공합니다. 클라이언트 라이브러리는 전송 과정을 간소화하지만, 불확실성을 해석하는 정책은 여전히 애플리케이션에서 마련해야 합니다.



## 자료

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

https://uptimescout.com/ko/methodology/

https://uptimescout.com/ko/contacts/
