API

[Luengooo]

• Meu nome em jogo:
R: Diganle | Luengo

• Meu tipo de conta (pirata/original):
R: Premium

• Qual é a minha dúvida:
R:
Estou desenvolvendo um bot de Discord que mostra, em uma tabela que se atualiza sozinha, o ranking de Killstreak atual (Arena) dos jogadores do Mush. Estou usando a API pública documentada no fórum (/leaderboard/{mode}, /player/{nameOrUuid}).

Tenho uma dúvida: existe algum endpoint (público ou que possa ser liberado) para o leaderboard por período, diário, semanal e mensal, igual ao que o Mush Stats mostra no comando /leaderboard arena ("Abates (Mensal)")? Hoje o /leaderboard/pvp só retorna o acumulado total (pvp:arena_kills), então jogadores novos ou ativos que ainda não estão no TOP 100 geral não aparecem no meu bot.

Se existir, poderia me dizer o caminho e os parâmetros? E se não existir, há alguma chance de ser adicionado no futuro?

Aproveitando: qual é o limite de requisições recomendado? Estou tomando 429 em alguns momentos e quero respeitar o limite da API para não ser bloqueado.

Muito obrigado pela ajuda.

Nick no jogo: Diganle | Luengo

[CRIS]

Olá, Diganle | Luengo! Obrigado por entrar em contato.

Sobre a API, a documentação oficial no tópico (https://forum.mush.com.br/topic/149525/documentação-api-mush) traz o seguinte:

• Leaderboard: GET /leaderboard/{mode} retorna o TOP 100 de um modo. Os modos listados são bedwars, skywars, bridge, hg, minimush, pvp, soup, gladiator, party, ctf, quickbuilders e murder. O tópico não cita parâmetros de período (diário, semanal ou mensal) para esse endpoint, nem outro endpoint com esse recorte.
• Perfil do jogador: GET /player/{nameOrUuid} retorna o perfil completo, e GET /player/{id_type}/{identifier}/{type} retorna dados específicos.
• Formato: o retorno é em JSON, não requer autenticação, e campos sem valor não são retornados, então devem ser tratados como opcionais.
• Limites: o tópico não informa um limite de requisições recomendado. Ele avisa apenas que uso indevido pode resultar em bloqueio.

Sobre a possibilidade de um leaderboard por período ser adicionado no futuro, o tópico não traz nenhuma informação, então não consigo confirmar isso. Também não posso orientar sobre como montar ou integrar seu bot além do que está documentado.

Para dados que não estejam nesse tópico, você pode consultar diretamente em https://mush.com.br/api/player/NICK_DO_JOGADOR, substituindo NICK_DO_JOGADOR pelo nick desejado.

Para outras dúvidas, crie um novo tópico.