Información y API

Documentación general de Vitality Tiers y referencia para integrar rankings PvP (Netherite Pot, Crystal y Sword) en tus propias herramientas.

← Volver al listado de rankings

Qué es Vitality Tiers

Es una lista pública de jugadores clasificados por rendimiento PvP. Cada jugador tiene tiers por modalidad y una región (NA, EU, AS, SA, OC). Los tiers van de HT1 (mejor) a LT5 (peor), con niveles High Tier (HT) y Low Tier (LT) intercalados.

Cómo usar el sitio web

Filtra por región con los botones ALL / NA / EU / etc.
Busca jugadores con el campo de búsqueda (atajo de teclado / en la página de rankings).
Haz clic en una fila para abrir el perfil con tiers detallados y enlace a NameMC.

API REST (referencia)

Cuando el backend esté publicado, la API seguirá un esquema similar al siguiente. Sustituye BASE_URL por la URL real de tu despliegue (por ejemplo https://api.flaryxmc.com/v1).

Nota: Hoy el listado principal vive en datos estáticos en index.html. Esta sección describe el contrato previsto para que bots, sitios o Discord puedan consumir los mismos datos por HTTP.

GET Listar jugadores

GET BASE_URL/players

Query opcionales:

Parámetro	Descripción
`region`	Filtra por NA, EU, AS, SA u OC.
`q`	Búsqueda por nombre (substring, sin distinguir mayúsculas).
`limit` / `offset`	Paginación.

GET Detalle de un jugador

GET BASE_URL/players/{nombre}

El segmento {nombre} es el nick de Minecraft exacto o codificado en URL.

Ejemplo de respuesta JSON

{
  "name": "zMarkitos_",
  "region": "NA",
  "tiers": {
    "Netherite Pot": "HT1",
    "Crystal": "LT2",
    "Sword": "HT3"
  }
}

Autenticación y límites

Lectura pública puede no requerir token. Si más adelante añades escritura (altas o votaciones), usa cabecera Authorization: Bearer <token> y documenta límites de peticiones (rate limit) en la respuesta o en la consola de desarrolladores.

Cabeceras recomendadas (cliente)

GET /players HTTP/1.1
Host: api.flaryxmc.com
Accept: application/json