Documentação: API - Mush

[yPandinho]

Olá, desenvolvedores!
Neste tópico você encontrará a documentação oficial dos endpoints públicos da API do Mush, voltada a desenvolvedores que desejam integrar bots, sites e ferramentas externas.

INFORMAÇÕES GERAIS:

Link da API: https://mush.com.br/api
• O retorno das informações é em JSON;
• Não requer autenticação;
• Uso indevido pode resultar em bloqueio.

---

ENDPOINT: PLAYER

| Buscar perfil do jogador via Profile ID:
GET /player/profileid/{profile_id}
https://mush.com.br/api/player/profileid/{profile_id}

| Buscar perfil do jogador via Name ou UUID:
GET /player/{nameOrUuid}
https://mush.com.br/api/player/{nameOrUuid}

---

ENDPOINT: DADOS ESPECÍFICOS DO JOGADOR

| Buscar dados específicos do jogador:
GET /player/{id_type}/{identifier}/{type}
https://mush.com.br/api/player/{id_type}/{identifier}/{type}

O identifier deve seguir o id_type informado.
Tipos de ID disponíveis (id_type):
• name;
• profileid;
• uuid;
Tipos de dados disponíveis (type):
• bedwars — Menu de compra rápida do Bed Wars;
• quickbuilders — Recordes do Quick Builders;
• missions — Missões;
• skywars — Perks selecionadas do Sky Wars;
• parkour — Recorde do Parkour nos Lobbies;
• cosmetics — Cosméticos selecionados.

---

ENDPOINT: GAME

| Buscar informações de uma partida:
GET /game/{game_id}
https://mush.com.br/api/game/{game_id}

Você pode obter o game_id através do comando /gameid ou pela scoreboard, exibido no topo dela.
Modos suportados pela API de game:
• Hunger Games;
• Bed Wars;
• Build Battle;
• Quick Builders;
• Murder.

---

ENDPOINT: LEADERBOARD

| Buscar o ranking (TOP 100) de um modo:
GET /leaderboard/{mode}
https://mush.com.br/api/leaderboard/{mode}

Modos disponíveis (mode):
• bedwars;
• skywars;
• bridge;
• hg;
• minimush;
• pvp;
• soup;
• gladiator;
• party;
• ctf;
• quickbuilders;
• murder.

---

ENDPOINT: XP TABLE

| Buscar tabela de progressão de XP por modo:
GET /games/{mode}/xptable
https://mush.com.br/api/games/{mode}/xptable

Modos disponíveis (mode):
• bedwars;
• skywars;
• duels.

---

ENDPOINT: PUNIÇÕES

| Buscar a lista de punições ocorridas no servidor:
GET /punishments?timerange={period}&punishtype={type}&viponly={boolean}
https://mush.com.br/api/punishments?timerange={period}&punishtype={type}&viponly={boolean}

O parâmetro viponly é opcional e booleano, ou seja, aceita os valores true ou false.
Períodos disponíveis (period):
• month;
• day;
Tipos de punição disponíveis (type):
• all;
• ban;
• mute;
• other.

É importante ressaltar que o endpoint de punições não possui suporte oficial e pode ser alterado ou removido a qualquer momento sem avisos.

[Thxago]

Oloco! Obrigado pelas informações, yPandinho!

[wal]

irado

[imChico]

irado

[islloww]

irado

[samuraigoat]

irado

[SpecialAiko]

Desculpa ser meio leigo no assunto mas oq é api kk

[samuraigoat]

@U3 Application Programming Interface, em inglês. É um conjunto de regras e protocolos que permite que diferentes aplicações de software se comuniquem e interajam entre si.

[tapioca]

irado msm

[Lz of Seven]

kd a api?? nao ta funcionando o link

[ApenasUnNoob]

maneiro

[feh]

@yPandinho a API ainda funciona?

[blacki]

@fer Está sim