Referencia de la API REST

Puedes consultar los datos en tiempo real del ranking, los perfiles y el estado de la red P2P usando nuestra API pública.

NOTE

Todos los endpoints públicos son de solo lectura (GET) y devuelven la información en formato application/json.

---

👤 Perfil del Jugador

Devuelve las estadísticas completas, el ELO actual, la posición global y la lista de todos los Récords Personales (PBs) de un jugador específico.

• URL: GET https://lfsrank.com/api/api_player.php?uname={nombre_usuario}
• Parámetros:
  • uname: El nombre de usuario exacto en Live for Speed (ej. dgrac).

Respuesta de Ejemplo

{
  "player": {
    "username": "dgrac",
    "elo": 1540,
    "global_rank": 3,
    "fav_car": "XF GTR",
    "fav_track": "Blackwood GP Track"
  },
  "stats": {
    "total_races": 42,
    "wins": 12,
    "podiums": 25,
    "total_distance_km": 340.5
  },
  "pbs": [
    {
      "track": "BL1",
      "car": "XFG",
      "best_time": 92350,
      "date": "2024-05-30"
    }
  ]
}

---

🌐 Estado de la Red

Devuelve los últimos bloques (carreras) recibidos por la red global, estén ya validados o en proceso de consenso.

• URL: GET https://lfsrank.com/api/races.php

Respuesta de Ejemplo

[
  {
    "id": 1054,
    "server_name": "Spain LFS Racing",
    "track": "AS1",
    "car_class": "TBO",
    "laps": 10,
    "winner_name": "danielin",
    "race_date": "2024-05-30 08:05:22"
  }
]