Visão Geral
APIs sobre o estado atual do mundo do jogo são sempre divertidas, então TTR publicou nosso rastreador de invasão interna para o mundo através de uma API de consumo público.
O design para esta API é impulsionado pela implementação de rastreamento de invasão real nos servidores TTR. Cada distrito envia periodicamente os dados atuais da invasão para um servidor central (embora esse servidor não seja nosso servidor web), onde eles são armazenados na memória. Em um timer separado, a camada web da TTR consulta periodicamente esse servidor central para obter os dados de invasão mais recentes, que são então armazenados em cache e devolvidos a todos que consultam a API de invasões. Este design é flexível e requer poucos recursos extras para operar, embora os dados não sejam tão frescos como resultado.
Note: O cabeçalho Access-Control-Allow-Origin está definido como * nesta API.
Requests
An HTTP GET to the invasions API endpoint, https://www.toontownrewritten.com/api/invasions, irá retornar a última resposta JSON. Nenhum parâmetro é necessário, no entanto, se você estiver fazendo chamadas a esta API com frequência, eu apreciaria se você definisse um User-Agent descritivo.
Resposta
| Nome | Detalhes |
|---|---|
| erro | Quando os dados estão presentes, error será definido como nulo. Se error não for nulo, então nenhum outro campo estará presente, e error será definido para uma mensagem de erro |
| invasões | Um dicionário de nomes de distritos para dados de invasão. |
| lastUpdated | O timestamp de época da última consulta de dados da camada web. |
Dados de invasão
| Nome | Detalhes |
|---|---|
| tipo | O nome da engrenagem invasora. O nome localizado será sempre em inglês, e será sempre a forma singular da engrenagem. Se a engrenagem for um esqueleto, (Skelecog) será anexado. Se a engrenagem for a versão 2.0, Version 2.0 será prefixada. |
| asOf | A última vez que o distrito reportou o seu estado de invasão. |
| progresso | Uma cadeia, da forma %d/%d, onde o primeiro número representa o número de engrenagens já despawned durante a invasão e o segundo número representa o tamanho total da invasão. |