Introducción a la REST API
SportsPress 2.0 introdujo endpoints para la WP REST API, permitiendo el acceso programático para gestionar los datos del sitio. El plugin requiere el plugin WP REST API (versión 2) para la funcionalidad básica. WordPress 4.7 y versiones posteriores incluyen la REST API de forma nativa — no se requiere ningún plugin adicional en instalaciones modernas de WordPress.
Las solicitudes GET (lectura de datos) no requieren autenticación. Las solicitudes POST, PUT y DELETE (creación, actualización o eliminación de datos) requieren autenticación.
URL base
Todos los endpoints de la REST API de SportsPress están disponibles en:
/wp-json/sportspress/v2/
Reemplaza example.com con el dominio de tu sitio:
https://example.com/wp-json/sportspress/v2/events
Endpoints disponibles
Recurso | Endpoint |
Eventos |
|
Equipos |
|
Jugadores |
|
Personal |
|
Calendarios |
|
Tablas de Liga |
|
Listas de Jugadores |
|
Cada endpoint admite las convenciones estándar de la WordPress REST API: listar todos los recursos con GET, recuperar un único recurso con GET /{id}, crear con POST, actualizar con PUT o PATCH, y eliminar con DELETE.
Métodos HTTP
Método | Acción |
| Recuperar uno o más recursos |
| Crear un nuevo recurso |
| Actualizar un recurso existente |
| Eliminar un recurso |
Autenticación
Se requiere autenticación para todas las operaciones de escritura. Consulta el artículo de Autenticación para obtener instrucciones de configuración usando Contraseñas de aplicación y Postman.
Limitaciones conocidas
Los jugadores creados a través de la REST API pueden no aparecer automáticamente en las listas de jugadores. Después de crear un jugador a través de la API, asigna manualmente el jugador al equipo correspondiente desde el panel de administración, o asegúrate de que la lista de jugadores esté configurada para incluir ese equipo.
Los eventos programados (futuros) requieren el valor de estado
futureal crearlos a través de la API.El parámetro de consulta
_fieldsestá disponible para filtrar campos de respuesta (disponible en SportsPress Pro 2.7.16 y posterior tras una corrección de un error de la API con_fields).
