POST /matches/:id/vote — cast or update a prediction

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/Danielsl4/TFG_DAM_2526_Consulta2/llms.txt

Use this file to discover all available pages before exploring further.

​

Cast or update a vote

POST /matches/:id/vote

​

Authentication

​

Path parameters

​

Body parameters

​

Restrictions

• The match status must be pendiente. Voting on a match that is en_curso or finalizado returns 400.
• Both homeTeam and awayTeam must be assigned (not null). Voting on a match with unresolved team slots returns 400.

​

Response

{
  "message": "Voto registrado correctamente",
  "votingStats": {
    "local": 15,
    "draw": 5,
    "away": 3,
    "total": 23
  }
}

​

Error responses

​

Point award logic

1. Determines the result: local (home goals > away goals), visitante (away goals > home goals), or empate (equal).
2. Marks all matching votes with points_awarded = 1.
3. Increments the points counter in user_points for every correct voter for the current season.

​

Examples

curl --request POST \
  --url 'https://api.example.com/matches/42/vote' \
  --header 'Authorization: Bearer <your_token>' \
  --header 'Content-Type: application/json' \
  --data '{ "vote": "local" }'

{
  "message": "Voto registrado correctamente",
  "votingStats": {
    "local": 15,
    "draw": 6,
    "away": 3,
    "total": 24
  }
}

​

Get last global activity

GET /matches/last-activity

​

Authentication

​

Response

{ "timestamp": 1747782061000 }