문서

서버 상태

로비와 메인 서버의 접속 인원을 가져옵니다. 키가 필요 없습니다.

이 문서의 목차 (3)

서버 상태#

GET /v1/status

키 불필요

프록시·로비·메인 서버를 한 번에 확인합니다.

curl https://api.mcmi.kr/v1/status

{
  "data": {
    "online": true,
    "players": { "online": 0, "max": 2027 },
    "servers": [
      {
        "id": "proxy",
        "name": "네트워크(프록시)",
        "online": true,
        "players": { "online": 0, "max": 2027 },
        "version": "Velocity 1.7.2-26.2",
        "latencyMs": 2
      },
      {
        "id": "lobby",
        "name": "로비",
        "online": true,
        "players": { "online": 0, "max": 100 },
        "version": "Leaf-Lib 1.21.8",
        "latencyMs": 3
      },
      {
        "id": "mainsv",
        "name": "메인 서버",
        "online": true,
        "players": { "online": 0, "max": 80 },
        "version": "Leaf-Lib 1.21.8",
        "latencyMs": 2
      }
    ],
    "byServer": { "lobby": 0, "mainsv": 0 }
  },
  "meta": { "generated_at": "2026-09-12T14:20:11.000Z", "cache_seconds": 10 }
}

필드#

필드뜻
data.online하나라도 살아 있으면 true
data.players네트워크 전체 접속 인원. 프록시 기준입니다
data.byServer서버별 인원. 어느 서버에 사람이 있는지 볼 때 쓰세요
data.servers[].latencyMsAPI 서버에서 잰 응답 시간입니다. 여러분의 핑이 아닙니다
중요

인원을 셀 때는 data.players.online 을 쓰세요.
byServer 의 합이 전체와 다를 수 있습니다. 서버를 옮기는 중인 분은 잠깐 양쪽 어디에도 잡히지 않을 수 있기 때문입니다.

참고

점검 중이거나 서버가 꺼져 있으면 해당 항목의 online 이 false 가 되고 players 는 null 이 됩니다. 이때도 응답 자체는 200 입니다 — "서버가 꺼져 있다"는 것도 정상적인 답이기 때문입니다.

이 응답은 10초 캐시됩니다. 더 자주 부르셔도 같은 값이 옵니다.

재화 목록#

GET /v1/economy/currencies

키 불필요

{
  "data": [
    { "id": "gold", "name": "골드", "symbol": "G" },
    { "id": "ruby", "name": "루비", "symbol": "R" }
  ]
}

API 개요 · 플레이어

댓글

댓글은 마코노미 디스코드 서버 멤버만 쓸 수 있어요. 디스코드로 로그인