De onde vêm os números do MetaRanked: um tour pelos bastidores

Esta é uma pergunta que chega direto no nosso e-mail todo mês: "de onde vocês pegam os dados? Isso é oficial?" A resposta curta é que o MetaRanked consome a API pública que a própria Riot Games mantém para desenvolvedores terceiros. A resposta longa vale um texto, porque entender o fluxo explica também por que às vezes os dados demoram um pouco, por que certas partidas não aparecem e por que a atualização manual existe.

Riot ID, PUUID e por que isso importa

Na sua conta Riot existem dois identificadores relevantes. O Riot ID é aquilo que você escreve no cliente (nome#tag). Ele pode ser trocado pelo próprio jogador. O PUUID é um identificador interno, imutável, único por conta em toda a Riot. Tudo o que o MetaRanked guarda é indexado por PUUID — isso significa que, mesmo que você troque de nome, seu histórico e perfil continuam atrelados corretamente à sua conta.

Quando você pesquisa um invocador pela primeira vez

O fluxo é o seguinte:

1. Você digita um Riot ID na busca.
2. Nosso backend consulta a API da Riot para resolver Riot ID → PUUID.
3. A partir do PUUID, pedimos dados adicionais: perfil (ícone, nível), elo atual em filas ranqueadas e a lista de IDs das partidas recentes.
4. Para cada partida "nova" (que ainda não está no nosso banco), pedimos os detalhes completos: participantes, campeões, itens, ouro, dano, objetivos e o timeline.
5. Processamos esse volume, calculamos métricas derivadas (KDA, participação em kills, desempenho por rota) e gravamos em banco.

A primeira consulta de um invocador "novo" pode levar de alguns segundos a alguns minutos porque estamos baixando partidas inéditas e respeitando os limites de taxa que a Riot impõe. A partir da segunda visita, o perfil abre rápido: a gente só busca as partidas que chegaram desde a última visita.

O botão "Atualizar Invocador"

O botão na página de perfil dispara uma varredura forçada: mesmo que exista cache, o backend vai até a Riot, pega os IDs mais recentes e processa quaisquer partidas novas. É útil quando você acabou de terminar uma partida e quer ver os números já integrados com o resto do histórico.

Esse fluxo é ativo: ele mostra fases no frontend (na fila, rodando, pronto ou falhou). Se falhar, quase sempre é porque a API da Riot está momentaneamente indisponível ou porque você ultrapassou o limite de atualizações manuais muito próximas — aguardar um minuto e repetir costuma resolver.

Data Dragon e o conteúdo "estático"

Todo elemento que não muda no meio da partida — imagens de campeão, ícones de itens, descrições de runas, splash arts — vem do Data Dragon, o CDN oficial de assets da Riot. A gente consome a versão mais recente e atualiza a referência quando um novo patch sai. Por isso, no dia em que um patch vai ao ar, pode haver um curto intervalo em que um item novo aparece sem ícone: é a janela entre a publicação do patch e a publicação do Data Dragon.

Retenção: por que partidas antigas somem

Armazenar partidas indefinidamente significaria crescimento de banco sem limite prático. A política atual é manter o histórico recente (últimos ~90 dias) integralmente para leitura rápida, e mover partidas mais antigas para um regime de agregados. Detalhes por partida ficam por esse período; contagens agregadas (winrate do campeão, ranking de temporada, recordes) são preservadas por janelas maiores. Se você procurar uma partida de seis meses atrás que não existe mais como detalhe, isso é esperado.

Por que às vezes tem diferença em relação ao cliente oficial

Três razões comuns, em ordem de frequência:

• Atraso de propagação. A partida que você terminou agora pode demorar até alguns minutos para aparecer na lista do match-v5. Atualizar de novo resolve.
• Cálculo derivado. Algumas métricas no MetaRanked (como "carga de dano por ouro gasto") são compostas por nós; pequenas divergências com ferramentas diferentes são esperadas porque cada uma define a fórmula a seu modo.
• Partidas remakes ou especiais. Partidas muito curtas, personalizadas ou de fila fora do normal (arena, cogumelo) podem ser filtradas porque distorceriam estatísticas de ranqueada.

O que o MetaRanked não vê

Para evitar dúvida: não temos acesso a nada privado da sua conta. Não temos sua senha, seu e-mail Riot, seu histórico de compras, RP, nem o seu chat. Tudo o que exibimos é público e disponível para qualquer pessoa que consulte a API com o seu Riot ID. Se algo que você considera sensível está público, isso é configuração do próprio cliente — não algo que o MetaRanked decide. Nosso tratamento de dados pessoais dos usuários registrados (e-mail, senha, username) está detalhado em Política de Privacidade.

Como reportar divergência

Se algo no seu perfil estiver claramente errado (partida faltando depois de 10 minutos, elo inconsistente com o cliente, campeão aparecendo na rota errada de forma recorrente), abra um chamado em contato com o link do perfil e o horário aproximado. É mais útil para nós do que um print: com o link, a gente consegue reconstruir o fluxo e identificar se o problema foi nosso, da Riot ou da combinação dos dois.