Convenciones

Todas las respuestas son JSON en UTF-8. Las fechas con hora siguen ISO 8601 con zona horaria (2026-09-20T18:30:00Z), y las fechas sin hora, el formato 2026-09-20. Los importes son números decimales en euros (1.00), nunca cadenas ni céntimos. Un campo ausente y un campo a null significan lo mismo: no hay dato.

Signos. Un signo es el resultado 1, X o 2 de un partido. Cuando la API da un signo como valor —por ejemplo, el resultado de un partido— usa las cadenas "ONE", "X" y "TWO". Cuando indica qué se marca en cada signo —en una marca de una columna o en unos porcentajes— usa tres campos con esos mismos nombres en minúsculas.

{ "result": "ONE" }
{ "number": 5, "one": true, "x": false, "two": false }

Personas. Cuando una respuesta se refiere a una persona, incluye dos campos: username, su nombre de usuario, que es único y la identifica, y name, el nombre que se muestra. Si la persona no ha indicado un nombre, name contiene su nombre de usuario.

{ "username": "ana_g", "name": "Ana García" }

Los listados que crecen con el tiempo, como las jornadas de una peña o los movimientos del saldo, están paginados. Se piden con page (desde 0) y size (20 por defecto, 100 como máximo), y la respuesta tiene siempre esta forma:

{
  "items": [ … ],
  "page": 0,
  "size": 20,
  "total": 138,
  "totalPages": 7
}

El orden de cada listado es fijo y forma parte de su significado —las jornadas, por temporada y número—, por lo que no hay parámetro para cambiarlo.