다른 사이트와 수집기가 접속자 수를 표시할 수 있는 읽기 전용 API입니다. 로그인·API 키·게임 입장은 필요하지 않습니다.
GET https://modoovillage.com/api/rooms → 최상위 total 정수를 사용하세요.
{"rooms":[{"id":1,"count":7,"capacity":100}],"total":7,"capacity":100,"maxRooms":50}
위 숫자는 설명용 예시입니다. total은 모든 채널의 현재 플레이어 연결 수 합계입니다. 첫 채널의 count만 사용하거나 total에 채널 인원을 더하지 마세요. 탭·연결별 집계로, 고유한 사람 수는 아닙니다. 운영자의 IP와 연결된 테스트 클라이언트도 포함하고 NPC는 제외합니다. 테스트 IP 제외는 비공개 방문 통계에만 적용됩니다.
GET https://modoovillage.com/api/health → {"ok":true}. 해당 상태 API의 응답 여부이며 모든 게임 기능의 정상 작동을 보증하는 값은 아닙니다.
서버에서 서버로 약 1분 이상의 간격으로 조회하세요. 응답은 Cache-Control: no-store이며 임의 브라우저 출처의 CORS는 보장하지 않습니다. HTTP·통신·JSON 형식 오류는 인원 미확인으로 처리하세요. 정상 응답의 total: 0만 실제 0명입니다. 성공한 조회 시각은 수집 측에서 기록하세요. online, online_at은 이 API의 필드가 아닙니다.
Fetch the public GET endpoint https://modoovillage.com/api/rooms server-to-server and use the top-level non-negative integer total as the live connected player-session count across all channels. It includes test clients and the owner's connections; private analytics filtering does not affect it. No authentication or game joining is needed. Unknown/error is not zero. Poll once per minute or less often and record your own successful sampling timestamp.