Resumen
Las APIs sobre el estado actual del mundo del juego siempre son divertidas, así que TTR ha publicado nuestro rastreador de invasiones interno al mundo a través de una API consumible públicamente.
El diseño de esta API está impulsado por la implementación del rastreo de invasiones real en los servidores de TTR. Cada distrito envía periódicamente los datos de la invasión actual a un servidor central (aunque ese servidor no es nuestro servidor web), donde se almacena en la memoria. En un temporizador separado, la capa web de TTR consulta periódicamente este servidor central para obtener los datos de invasión más recientes, que luego se almacenan en la memoria caché y se devuelven a todos los que consultan la API de invasiones. Este diseño es flexible y requiere pocos recursos adicionales para operar, aunque los datos no son tan frescos como resultado.
Nota: El encabezado Access-Control-Allow-Origin se establece en * en esta API.
Solicitudes
Un GET HTTP al punto final de la API de invasiones, https://www.toontownrewritten.com/api/invasions, devolverá la última respuesta JSON. No se requieren parámetros, sin embargo, si usted está haciendo con frecuencia las llamadas a esta API, le agradecería si se establece un descriptivo User-Agent.
Respuesta
| Nombre | Detalles |
|---|---|
| error | Cuando los datos están presentes, error se pondrá a cero. Si error no es nulo, entonces ningún otro campo estará presente, y error se establecerá en un mensaje de error |
| invasiones | Un diccionario de nombres de distrito a datos de invasión. |
| lastUpdated | La marca de tiempo de la época en que la capa web consultó por última vez los datos. |
Datos de la invasión
| Nombre | Detalles |
|---|---|
| tipo | El nombre del engranaje invasor. El nombre localizado siempre estará en inglés, y siempre será la forma singular del cog. Si el engranaje es un skelecog, se añadirá (Skelecog). Si el engranaje es la versión 2.0, se añadirá Version 2.0 . |
| asOf | La marca de tiempo de la última vez que el distrito informó de su estado de invasión. |
| progreso | Una cadena, de la forma %d/%d, donde el primer número representa el número de engranajes ya despawned durante la invasión y el segundo número representa el tamaño total de la invasión. |