Ir directamente al contenido
Español
  • No hay sugerencias porque el campo de búsqueda está vacío.

🔌 Preguntas frecuentes: Provider API

Una extensión para que los proveedores recuperen automáticamente sus horarios de actividades a través de una interfaz de programación de aplicaciones (API)

 


Qué es la Provider API?

La Provider API es una extensión que te permite usar los datos de tu Eversports Manager fuera de Eversports: en tu propia web, en tu propia app o en las herramientas de negocio que ya utilizas. Puedes conectar Eversports con software existente o crear algo nuevo sobre él.

Piensa en ella como una ventana segura a tu cuenta. Tu desarrollador o agencia la utiliza para obtener tus datos a intervalos regulares y mostrarlos donde los necesites. Cuando un cliente quiere reservar o comprar, se le redirige al Checkout de Eversports, de modo que las reservas y los pagos siguen gestionándose a través de Eversports.

Este artículo está dirigido a propietarios de estudios, gimnasios y clubes que quieren saber qué es posible antes de hablar con un desarrollador. No se necesitan conocimientos técnicos.


¿Necesito la Provider API?

Quizás no. Si solo quieres mostrar un horario y permitir reservas en tu web, los widgets de Eversports lo hacen sin necesidad de un desarrollador.

La Provider API es la mejor opción cuando quieres:

  • Tu propio diseño o app, más allá de lo que ofrecen los widgets.
  • Combinar los datos de Eversports con otras herramientas, como un CRM, una herramienta de newsletters o de informes.
  • Tus propios informes sobre asistencia, socios o uso de pistas.

¿Qué datos están disponibles?

La API da acceso a ocho áreas de tu cuenta de Eversports. Cada una puede filtrarse, por ejemplo, por centro, rango de fechas, deporte o profesor. Solo se incluyen los centros que actives para tu integración.

Área Qué puedes obtener Útil para
Tu empresa y tus centros Nombre de la empresa, nombres de los centros, direcciones, coordenadas del mapa, fotos y zona horaria Páginas de ubicaciones, localizadores de centros, mapas
Horarios de actividades Clases, entrenamientos, cursos, talleres, campamentos, retiros, eventos y formaciones, con fechas, horarios, sala, nivel, color de categoría, descripción e imágenes Horarios y páginas de cursos en tu web
Datos de reserva Si una actividad se puede reservar, plazas totales y libres, plazo de reserva, plazo de cancelación y un enlace de Checkout único Mostrar disponibilidad y dirigir a las personas a reservar
Profesores Nombres, fotos, biografía y formación, además de las actividades que imparten Páginas del equipo y listados de "clases con este profesor"
Productos Bonos, abonos temporales y membresías, con sus reglas de uso y un enlace para comprarlos Páginas de precios
Clientes Nombre, email, fecha de nacimiento, foto de perfil, estado de archivo y consentimiento de contacto Mantener sincronizado un CRM o una herramienta de newsletters
Productos de clientes Los bonos y membresías que tiene cada cliente, cuánto han usado, cuándo caducan y posibles pausas Áreas de socios y recordatorios de renovación
Asistencia y reservas de pistas Quién se ha apuntado a qué actividad o pista, si ha asistido y las cancelaciones tardías Informes de asistencia, ausencias y uso de salas

👉 Para consultar la información técnica detallada sobre los datos disponibles, puedes ver el esquema completo en https://provider-api.eversportsmanager.io/api/graphql.


¿Qué puedo crear con ella?

🌐 En tu web

  • Un horario con tu propio diseño. Muestra las actividades de la semana con tus colores, filtros por deporte o nivel y un botón de "Reservar ahora" en cada una.
  • Páginas de cursos y talleres. Dale a cada curso su propia página con descripción, fotos, fechas, profesor y plazas disponibles.
  • Etiquetas de "casi completo". Muestra cuándo una actividad está a punto de llenarse o agotada, según tu última sincronización.
  • Perfiles de profesores. Muestra la foto y la biografía de cada profesor, con sus próximas actividades debajo.
  • Una página de precios. Lista tus bonos y membresías, cada uno con un enlace de "Comprar ahora".
  • Una página de ubicaciones o un mapa. Muestra todos tus centros con su dirección y su marcador en el mapa.

👥 Para tus socios

  • Un área de socios en tu propia app. Permite a tus socios ver cuántas clases les quedan en su bono, cuándo se renueva su membresía y sus visitas anteriores.
  • Recordatorios. Envía un mensaje amable cuando un bono está casi agotado o una membresía está a punto de terminar.

🏢 Para tu equipo

  • Sincronización con CRM y newsletters. Mantén actualizados los datos de tus clientes en tus otras herramientas y escribe solo a quienes hayan aceptado recibir comunicaciones de marketing.
  • Informes de asistencia. Haz seguimiento de ausencias, cancelaciones tardías y de qué actividades se llenan más.
  • Uso de pistas y salas. Consulta lo ocupada que ha estado cada pista o sala, por día y franja horaria.
  • Pantallas en tu centro. Muestra las actividades del día en una pantalla en recepción.

¿Qué no incluye?

Algunos datos no están disponibles a través de la API, así que tenlo en cuenta al planificar:

  • Datos financieros: facturas, pagos e ingresos.
  • Disponibilidad de pistas: puedes ver las reservas de pistas que se han realizado, pero no qué franjas siguen libres.
  • Otros productos: solo se incluyen bonos, abonos temporales y membresías; no se incluyen vales, artículos ni bonos para reservas de pistas.
  • Sesiones privadas: quedan fuera de los horarios, a menos que tu desarrollador las consulte de forma específica.

¿Se pueden añadir o modificar datos con la Provider API?

No. La Provider API es de solo lectura: puedes obtener datos de Eversports Manager, pero no añadir, modificar ni cancelar nada. Así, tus reglas, precios y pagos permanecen en un único lugar. 🔒


¿Pueden los clientes iniciar sesión a través de la Provider API?

No directamente. Cada actividad reservable incluye un enlace de Checkout único que lleva a los clientes al Checkout de Eversports. Un recorrido de reserva típico es así:

  1. Tu web muestra tus actividades, usando los datos obtenidos de la API.
  2. Un cliente hace clic en "Reservar ahora" y llega al Checkout de Eversports.
  3. Inicia sesión y utiliza un bono o una membresía que ya tenga, o compra uno nuevo.
  4. La reserva se guarda en Eversports y aparece en los datos de la API, por ejemplo, en los informes de asistencia.

¿Cuánto cuesta utilizar la Provider API?

Los precios empiezan en 50 € al mes por centro. Pueden variar según el tamaño de tu estudio y el uso que tengas previsto para la API. Escribe a support@eversports.com para recibir un presupuesto. 💶


¿Para qué puedo usar la API? ¿Qué límites de uso se aplican?

La API está pensada para copiar tus datos en tu propio sistema a intervalos regulares. No debe utilizarse como el backend directo de tu web o app; por ejemplo, cargando el horario desde la API cada vez que alguien visita tu página.

Por lo demás, la API funciona bajo un criterio de uso razonable. No hay un límite fijo de solicitudes, pero todas las integraciones se supervisan y el uso excesivo o dañino puede restringirse.


¿Qué tecnología utiliza la Provider API?

La Provider API de Eversports está desarrollada con GraphQL, un lenguaje de consulta para tu API.

Las API de GraphQL permiten definir con precisión y solicitar únicamente los datos que realmente necesitas, y recibirlos en formato JSON.

Puedes explorar de forma interactiva el esquema de nuestra API y su funcionalidad en https://provider-api.eversportsmanager.io/api/graphql.


Términos clave

Es posible que tu desarrollador utilice estos términos. Esto es lo que significan:

Término Significado
Empresa (Company) Tu negocio como entidad legal. Puede tener uno o varios centros.
Centro (Venue) Una de tus ubicaciones, como un estudio o un gimnasio.
Actividad (Activity) Una sesión individual en un horario concreto, por ejemplo, la clase de yoga del lunes a las 7:00.
Grupo de actividades (Activity group) Una serie de actividades, como una clase semanal o un curso de 6 semanas.
Unidad reservable (Bookable unit) Lo que reserva un cliente: una clase individual o un curso completo.
Enlace de Checkout (Checkout link) El enlace que lleva al cliente al Checkout de Eversports para reservar o comprar.
Producto (Product) Un bono o una membresía que vendes.
Producto de cliente (Customer product) Un bono o una membresía que tiene un cliente.
Participación (Participation) La inscripción de un cliente en una actividad.

🚀 ¿Cómo empiezo?

Para empezar a desarrollar tu integración, estaremos encantados de facilitarte las credenciales de acceso y una guía de inicio rápido para que realices tu primera solicitud en menos de 5 minutos. ⏱️

Para más información, escríbenos a support@eversports.com.


❓ ¿Sigues teniendo dudas? ¡Estamos aquí para ayudarte!

Si no estás seguro de si esta función es adecuada para tu negocio o necesitas ayuda para configurarla, no dudes en contactarnos.

📚 Consulta nuestro Centro de ayuda para ver guías y tutoriales detallados.

💬 Contacta con nuestro equipo de soporte si necesitas asistencia personalizada. Estaremos encantados de ayudarte a sacar el máximo partido a Eversports.

👉 Contacta con soporte: support@eversports.com