Bem-vindo à documentação da API do MapleStatus.info! Aqui você encontrará informações sobre como usar nossa API para obter o status mais recente dos servidores. Nossas APIs alimentam nossos monitores de status e permitem que desenvolvedores como você as acessem para usar em seus próprios projetos. A documentação para nossas APIs REST está disponível abaixo.

Primeiros Passos

Antes de começar, pedimos que (caso use nossas APIs em um projeto público) por favor nos dê os créditos sempre que possível. Inclua um link para o nosso site e incentive as pessoas a nos apoiarem.

Falando em apoio, este site não funciona de graça. Existem custos de operação do site e de seus servidores. Se você puder, pedimos a sua ajuda para continuar! Sua contribuição ajuda a pagar os servidores, ferramentas de desenvolvimento e aquele cafezinho para manter o dev feliz! 😊

Autenticação

Nossa API é aberta e gratuita. Não exigimos nenhuma autenticação para uso. No entanto, pedimos que siga nossas diretrizes e respeite nossos servidores. Reservamo-nos o direito de bloquear qualquer endereço IP que abuse de nossos serviços.

Limites de Requisição

Atualmente existe um limite de 500 requisições por minuto. Note que cada minuto começa no segundo 0 e não a partir da sua primeira requisição.

Referência da API REST

URL Base da API

Todas as URLs mencionadas nesta documentação utilizam o endereço abaixo como base.

https://maplestatus.info/api

GET Listar jogos

/games

Exemplo de resposta (/games):

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

GET Obter informações do jogo

/games/:game_id

Exemplo de resposta (/games/maplestory):

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

GET Listar regiões do jogo

/games/:game_id/locales

Exemplo de resposta (/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 Obter informações da região

/games/:game_id/:locale_id

Exemplo de resposta (/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 Listar todos os mundos do jogo

/games/:game_id/:locale_id/worlds

Exemplo de resposta (/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 Listar mundos e seus respectivos servidores

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

Exemplo de resposta (/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 Listar servidores de um mundo

/games/:game_id/:locale_id/:world_id

Exemplo de resposta (/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 Obter informações de um servidor

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

Exemplo de resposta (/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"
  }
}