欢迎查阅 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"
  }
}