Conceptos
Los términos del dominio de la quiniela y el nombre con el que aparece cada uno en la API.
Idioma de la API
Las rutas, los nombres de campo y los valores de los enumerados están en inglés, igual que los mensajes de error. Es la convención habitual en las APIs públicas: permite integrarla con generadores de clientes, bibliotecas y herramientas sin traducir identificadores, y la hace legible para cualquier equipo de desarrollo, sea cual sea su idioma.
Conceptos
La quiniela es un juego de pronósticos sobre los partidos de fútbol de una semana: catorce partidos a signo y un decimoquinto, el pleno al 15, a número de goles. La API modela ese juego con los conceptos siguientes.
| Concepto | En la API | Descripción |
|---|---|---|
| Temporada | season | Agrupa las jornadas de un año futbolístico y es la unidad sobre la que se puntúa. Se identifica por el año en que empieza: 2026 es la temporada 2026/27. |
| Jornada | round | Los partidos de una semana, con su fecha de apertura y de cierre. Se identifica por su temporada y su número dentro de ella: la jornada 7 de la 2026/27 es seasons/2026/rounds/7. |
| Partido | match | Cada uno de los catorce partidos que se juegan a signo. Se identifica por su número en el boleto (number), del 1 al 14, que es como se refiere a él un pronóstico. Cada uno dice además de qué competición y jornada es (competition), que es por donde se llega a su marcador en los datos de fútbol. |
| Signo | ONE · X · TWO | El resultado de un partido: gana el local (1), empate (X) o gana el visitante (2). Como clave se escribe one, x y two. |
| Pleno al 15 | match15 | El decimoquinto partido, que no se juega a signo sino a goles de cada equipo, en cuatro casillas: 0, 1, 2 y M (tres o más). Se llama igual en la jornada y en el pronóstico. Hay uno por pronóstico, no uno por columna. |
| Competición | competition | Una liga, una copa o un torneo de selecciones, con los equipos que la juegan cada temporada y su clasificación. Se identifica por su id (laliga-ea-sports), que no cambia aunque la competición cambie de nombre. Sus jornadas son las suyas y no coinciden con las de la quiniela, que mezcla partidos de varias competiciones. |
| Peña | community | Un grupo de personas que juega en común. Se identifica por su slug (bar-manolo), no por un id numérico. Cada peña define sus reglas: quién puede pronosticar, cómo se reparte el premio y cuántas columnas puede jugar cada socio. |
| Por tu cuenta | solo | Jugar la quiniela sin peña, con las mismas rutas que una peña pero empezando por /v1/solo/seasons en vez de por la peña y su slug. |
| Pronóstico | forecast | Lo que una persona juega en una jornada dentro de una peña: un pleno al 15 y una o varias columnas. Si la peña lo permite, puede haber varios por persona, numerados desde 1 (/forecast/{number}). |
| Columna | columnspicks | Un signo para cada uno de los catorce partidos. Cada uno de esos catorce es una marca (picks): el number del partido y cuál de one, x o two juega. |
| Plantilla | templates | Un conjunto de reglas que propone columnas o plenos. Se puede aplicar a mano o asignar una a una peña para que juegue por ti cada jornada (auto-play). |