Repository navigation
서버 상태 오류 구분과 기존 ping 응답 계약 정리 - #1
Merged
Merged
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Minecraft 서버 접속 실패와 API 내부 오류가 모두
HTTP 200 / result: false로 반환되어, 런처의 온라인 전환 감지가 API 장애를 오프라인으로 해석할 수 있었습니다. 정상 접속 불가는 기존 응답을 유지하고 주소 오류는 400, 프로토콜·조회 오류는 502, API 내부 오류는 500으로 구분하며 오류 응답은 캐싱하지 않습니다.기존
status.latency가 이미 API 서버 → Minecraft status 응답 지연 시간(ms)을 제공하므로 중복 필드 없이 유지합니다. 측정값 누락·음수·비유한 값은 null로 직렬화하고 나머지 status 구조는 보존합니다. DNS와 status 요청 전체에 3초 제한을 적용하고, 기존 잘못된 오프라인 캐시를 재사용하지 않도록 cache namespace를 분리했습니다.README와 OpenAPI에 운영 endpoint, 온라인·오프라인·오류 응답 예시, 측정 방식, timestamp 의미, 60초 캐시와 polling 권장 주기, 런처 연동 방법을 정리했습니다. 운영 응답에는
status.motd.clean이 없다는 기존 계약 차이도 명시했습니다.검증:
python -m unittest discover -s tests -v: 16개 통과https://mcstatus.snowfrost.kr/java/{address}, 기존status.latency제공. 호스트·경로 전환 불필요운영 배포와 운영 Redis 연결 검증은 수행하지 않았습니다. 런처 저장소는 수정하지 않았습니다.