歡迎查閱 MapleStatus.info API 說明文件！在此您可以了解如何調用 API 以取得最新伺服器狀態。本站的伺服器檢查工具亦是由這些 API 驅動，歡迎開發者將其應用於您自己的專案中。下方提供了 REST API 的詳細參考指南。

開始使用

若您在公開專案中使用我們的 API，請務必在可行之處註明來源。請分享我們的網站連結並鼓勵使用者向我們贊助。

本站的營運與伺服器維護均存在成本。若本服務對您有所幫助，懇請在力所能及的情況下為我們贊助。您的支持將用於支付伺服器費用、提升開發效率的專業工具，以及請開發者喝杯咖啡！😊

身份驗證

我們的 API 是完全開放且免費的，無需任何身份驗證即可調用。但請遵守使用規範並尊重伺服器負載。我們保留對濫用服務的 IP 位址進行封禁的權利。

頻率限制

目前的調用頻率限制為每分鐘 500 次請求。請注意，限制計數器在每分鐘的第 0 秒重置，而非從您的第一次請求開始計算。

REST API 參考

API 根網址

本文件提到的所有 URL 均基於以下根網址。

https://maplestatus.info/api

GET 取得遊戲列表

/games

回應範例 (/games):

[
  {
    "_id": "maplestory",
    "name": "MapleStory",
    "background": "maplestory_worldsunite.jpg"
  }
]

GET 取得遊戲詳情

/games/:game_id

回應範例 (/games/maplestory):

{
  "_id": "maplestory",
  "name": "MapleStory",
  "background": "maplestory_worldsunite.jpg"
}

GET 取得遊戲區域列表

/games/:game_id/locales

回應範例 (/games/maplestory/locales):

[
  {
    "_id": "global",
    "name": "MapleStory Global",
    "localized": {
      "ko": "메이플스토리 글로벌"
    },
    "website": "http://maplestory.nexon.net",
    "background": "maplestory_worldsunite.jpg",
    "is_default": 1
  },
  {
    "_id": "sea",
    "name": "MapleStorySEA",
    "localized": {
      "ko": "메이플스토리 동남아시아"
    },
    "website": "http://maplesea.com",
    "background": "maplestory_worldsunite.jpg",
    "is_default": 0
  },
  {
    "_id": "korea",
    "name": "MapleStory Korea",
    "localized": {
      "ko": "메이플스토리 대한민국"
    },
    "website": "http://maplestory.nexon.com",
    "background": "maplestory_worldsunite.jpg",
    "is_default": 0
  },
  {
    "_id": "japan",
    "name": "MapleStory Japan",
    "localized": {
      "ko": "메이플스토리 일본"
    },
    "website": "https://maplestory.nexon.co.jp/",
    "background": "maplestory_worldsunite.jpg",
    "is_default": 0
  },
  {
    "_id": "china",
    "name": "MapleStory China (冒险岛)",
    "localized": {
      "ko": "메이플스토리 중국 (冒险岛)",
      "zh-CN": "冒险岛",
      "zh-TW": "冒险岛",
      "zh": "冒险岛"
    },
    "website": "http://mxd.sdo.com/web6/index/index.asp",
    "background": "maplestory_worldsunite.jpg",
    "is_default": 0
  },
  {
    "_id": "taiwan",
    "name": "MapleStory Taiwan (新楓之谷)",
    "localized": {
      "ko": "메이플스토리 대만 (新楓之谷)",
      "zh-TW": "新楓之谷",
      "zh-CN": "新楓之谷",
      "zh": "新楓之谷"
    },
    "website": "https://tw.beanfun.com/maplestory/",
    "background": "maplestory_worldsunite.jpg",
    "is_default": 0
  },
  {
    "_id": "korea-test",
    "name": "MapleStory Korea Test",
    "localized": {
      "ko": "메이플스토리 테스트월드 "
    },
    "website": "https://maplestory.nexon.com/Testworld/Main",
    "background": "maplestory_worldsunite.jpg",
    "is_default": 0
  }
]

GET 取得遊戲區域詳情

/games/:game_id/:locale_id

回應範例 (/games/maplestory/global):

{
  "_id": "global",
  "name": "MapleStory Global",
  "localized": {
    "ko": "메이플스토리 글로벌"
  },
  "website": "http://maplestory.nexon.net",
  "background": "maplestory_worldsunite.jpg",
  "is_default": 1,
  "game_parent": "MapleStory",
  "game_slug": "maplestory"
}

GET 取得遊戲全部世界列表

/games/:game_id/:locale_id/worlds

回應範例 (/games/maplestory/global/worlds):

[
  {
    "_id": "login-north-america",
    "name": "Login (North America)",
    "icon": "mushroom"
  },
  {
    "_id": "login-europe",
    "name": "Login (Europe)",
    "icon": "mushroom"
  },
  {
    "_id": "scania",
    "name": "Scania",
    "icon": "scania"
  },
  {
    "_id": "bera",
    "name": "Bera",
    "icon": "bera"
  },
  {
    "_id": "aurora",
    "name": "Aurora",
    "icon": "aurora"
  },
  {
    "_id": "elysium",
    "name": "Elysium",
    "icon": "elysium"
  },
  {
    "_id": "reboot",
    "name": "Reboot",
    "icon": "reboot"
  },
  {
    "_id": "luna",
    "name": "Luna",
    "icon": "luna"
  },
  {
    "_id": "reboot-europe",
    "name": "Reboot (Europe)",
    "icon": "reboot"
  }
]

GET 取得全部世界及其所屬伺服器列表

/games/:game_id/:locale_id/worlds/servers

回應範例 (/games/maplestory/global/worlds/servers):

[
  {
    "info": {
      "_id": "login-north-america",
      "name": "Login (North America)",
      "icon": "mushroom"
    },
    "data": [
      {
        "_id": "login-1",
        "name": "Login 1",
        "status": true,
        "latency": {
          "now": {
            "rating": "normal",
            "value": 21
          }
        },
        "last_updated": "2019-09-10T16:04:06+00:00"
      },
      {
        "_id": "login-2",
        "name": "Login 2",
        "status": true,
        "latency": {
          "now": {
            "rating": "normal",
            "value": 21
          }
        },
        "last_updated": "2019-09-10T16:04:06+00:00"
      },
      {
        "_id": "login-3",
        "name": "Login 3",
        "status": true,
        "latency": {
          "now": {
            "rating": "normal",
            "value": 20
          }
        },
        "last_updated": "2019-09-10T16:04:06+00:00"
      },
      {
        "_id": "cross-world",
        "name": "Cross World",
        "status": true,
        "latency": {
          "now": {
            "rating": "normal",
            "value": 21
          }
        },
        "last_updated": "2019-09-10T16:04:06+00:00"
      }
    ]
  },
  {
    "info": {
      "_id": "login-europe",
      "name": "Login (Europe)",
      "icon": "mushroom"
    },
    "data": [
      {
        "_id": "login",
        "name": "Login",
        "status": true,
        "latency": {
          "now": {
            "rating": "normal",
            "value": 145
          }
        },
        "last_updated": "2019-09-10T16:04:07+00:00"
      }
    ]
  }
]

GET 取得特定世界下的所有伺服器列表

/games/:game_id/:locale_id/:world_id

回應範例 (/games/maplestory/global/login-north-america):

{
  "info": {
    "_id": "login-north-america",
    "name": "Login (North America)",
    "icon": "mushroom"
  },
  "data": [
    {
      "_id": "login-1",
      "name": "Login 1",
      "status": true,
      "latency": {
        "now": {
          "rating": "normal",
          "value": 21
        }
      },
      "last_updated": "2019-09-10T16:12:01+00:00"
    },
    {
      "_id": "login-2",
      "name": "Login 2",
      "status": true,
      "latency": {
        "now": {
          "rating": "normal",
          "value": 21
        }
      },
      "last_updated": "2019-09-10T16:12:01+00:00"
    },
    {
      "_id": "cross-world",
      "name": "Cross World",
      "status": true,
      "latency": {
        "now": {
          "rating": "normal",
          "value": 21
        }
      },
      "last_updated": "2019-09-10T16:12:01+00:00"
    }
  ]
}

GET 取得伺服器詳情

/games/:game_id/:locale_id/:world_id/:server_id

回應範例 (/games/maplestory/global/login-north-america/cross-world):

{
  "info": {
    "_id": "login-north-america",
    "name": "Login (North America)",
    "icon": "mushroom"
  },
  "data": {
    "_id": "cross-world",
    "name": "Cross World",
    "status": true,
    "latency": {
      "now": {
        "rating": "normal",
        "value": 21
      },
      "last_24h": {
        "rating": "normal",
        "value": 21
      },
      "last_3d": {
        "rating": "normal",
        "value": 21
      },
      "last_7d": {
        "rating": "normal",
        "value": 21
      },
      "last_14d": {
        "rating": "normal",
        "value": 21
      },
      "last_30d": {
        "rating": "normal",
        "value": 21
      }
    },
    "history": null,
    "sid": 39,
    "last_updated": "2019-09-10T16:14:04+00:00"
  }
}