Jugadores

Endpoint: /wp-json/sportspress/v2/players

Definiciones de campos

Campos de identificación y publicación

Campo	Descripción
`id`	Identificador único del objeto (entero, solo lectura)
`guid`	Identificador único global (solo lectura)
`slug`	Identificador alfanumérico compatible con URL, único para su tipo
`link`	URL del objeto (solo lectura)
`date`	Marca de tiempo de publicación en la zona horaria del sitio (ISO 8601)
`date_gmt`	Fecha de publicación en GMT (ISO 8601)
`modified`	Fecha de última modificación en la zona horaria del sitio (solo lectura)
`modified_gmt`	Fecha de última modificación en GMT (solo lectura)
`status`	Estado de publicación; uno de `publish`, `future`, `draft`, `pending` o `private`

Campos de contenido y metadatos

Campo	Descripción
`title`	El nombre del jugador
`content`	La biografía o descripción del jugador
`excerpt`	Un breve resumen del jugador
`featured_media`	El ID de la foto del jugador (imagen destacada)
`author`	El ID de la cuenta de usuario del creador

Campos de estado y acceso

Campo	Descripción
`password`	Una contraseña para proteger el acceso al contenido y al extracto
`comment_status`	Si los comentarios están abiertos o no; `open` o `closed`
`ping_status`	Si el objeto puede recibir pings o no; `open` o `closed`
`menu_order`	El orden del objeto en relación con otros objetos de su tipo

Campos de taxonomía

Campo	Descripción
`leagues`	Los términos asignados al objeto en la taxonomía de ligas (array de IDs de términos)
`seasons`	Los términos asignados al objeto en la taxonomía de temporadas (array de IDs de términos)
`positions`	Los términos asignados al objeto en la taxonomía de posiciones (array de IDs de términos)

Campos específicos del jugador

Campo	Descripción
`number`	El número de dorsal del jugador (entero)
`nationalities`	Códigos de país de 3 letras para las nacionalidades del jugador (array de cadenas)
`teams`	Los IDs de todos los equipos con los que está afiliado el jugador (array — actuales y anteriores)
`current_teams`	Los IDs de las afiliaciones de equipo actuales del jugador (array)
`past_teams`	Los IDs de las afiliaciones de equipo históricas del jugador (array)
`metrics`	Medidas de rendimiento del jugador (valores estáticos como altura, peso)
`statistics`	Datos de rendimiento basados en liga y temporada (valores calculados)

La mayoría de los campos admiten múltiples contextos (view, edit, embed), controlando la visibilidad y los permisos de modificación en diferentes escenarios de acceso a la API.

Limitación conocida

Los jugadores creados a través de la REST API pueden no aparecer automáticamente en las listas de jugadores. Esta es una limitación conocida documentada en el foro de soporte. Después de crear un jugador a través de la API, verifica que el jugador esté asignado al equipo correcto en el panel de administración de WordPress, y que la lista de jugadores esté configurada para incluir jugadores de ese equipo.

Ejemplos de solicitudes

Listar todos los jugadores

GET /wp-json/sportspress/v2/players

Recuperar un jugador individual

GET /wp-json/sportspress/v2/players/55

Crear un jugador

POST /wp-json/sportspress/v2/players
Content-Type: application/json{
  "title": "John Smith",
  "status": "publish",
  "number": 10,
  "nationalities": ["eng"],
  "current_teams": [10],
  "leagues": [5],
  "seasons": [3],
  "positions": [7]
}

Actualizar métricas de un jugador

PUT /wp-json/sportspress/v2/players/55
Content-Type: application/json{
  "metrics": {
    "height": "180",
    "weight": "75"
  }
}

Nota: La actualización de métricas de jugadores a través de la REST API requiere SportsPress Pro 2.7.3 o posterior.

Filtrar jugadores por liga y temporada

GET /wp-json/sportspress/v2/players?leagues=5&seasons=3

El filtrado del endpoint de lista de jugadores fue añadido en SportsPress Pro 2.5.5.