Necesitas una API para listar las partes del cuerpo que tu aplicación soporta, para que los usuarios puedan explorar ejercicios por región (pecho, espalda, hombros, etc.). Al final de esta guía, obtendrás esa lista en una sola llamada, la integrarás en tu interfaz de usuario y verás cómo obtener ejercicios relacionados y sesiones de entrenamiento completas de la misma fuente.
Lo que esta API te ofrece
La API de Base de Datos de Ejercicios en Zyla API Hub devuelve datos de fitness estructurados que puedes enviar rápidamente. Incluye:
- Una lista canónica de partes del cuerpo para alimentar filtros y navegación.
- Alternativas de ejercicios con el mismo movimiento o músculo objetivo.
- Creación de programas que generan una sesión lista para ejecutar (series, repeticiones, descanso, músculos objetivo y enlaces multimedia).
- Búsqueda del entrenamiento de hoy para un programa existente.
Se utiliza comúnmente para constructores de entrenamientos, flujos de incorporación de fitness, tableros de entrenamiento y interfaces de descubrimiento de ejercicios.
Comenzando en Zyla API Hub
Zyla API Hub centraliza más de 10,000 APIs públicas con una cuenta, una clave API y un modelo de suscripción + cuota (no pago por llamada). Para la API de Base de Datos de Ejercicios, puedes comenzar una prueba de 7 días o una cuota de solicitudes limitada para evaluar. No hay Plan Gratuito; consulta la página de la API para opciones de acceso y precios actuales.
Para comenzar:
- Abre la página de la API de Base de Datos de Ejercicios y suscríbete: Comienza la prueba de 7 días en la API de Base de Datos de Ejercicios.
- Copia tu clave API.
- Llama a los endpoints usando Authorization: Bearer YOUR_API_KEY.
Endpoint: Lista de Partes del Cuerpo
Obtén el conjunto canónico de partes del cuerpo para poblar menús desplegables, pestañas o navegación. No se requieren parámetros.
Método HTTP: GET
URL de solicitud: https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts
ejemplo de curl
curl -s -X GET "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts" \
-H "Authorization: Bearer YOUR_API_KEY"Respuesta real
[
"cintura",
"piernas superiores",
"espalda",
"piernas inferiores",
"pecho",
"brazos superiores",
"cardio",
"hombros",
"brazos inferiores",
"cuello"
]Normalmente, mapearás estas cadenas a etiquetas localizadas en tu aplicación y las usarás como claves para filtrar la búsqueda de ejercicios o enrutar a vistas de detalle.
ejemplo en Python
Este fragmento obtiene la lista y la prepara para la visualización en la interfaz de usuario. Reemplaza YOUR_API_KEY antes de ejecutar.
import requests
API_KEY = "YOUR_API_KEY"
URL = "https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts"
resp = requests.get(URL, headers={"Authorization": f"Bearer {API_KEY}"}, timeout=20)
resp.raise_for_status()
body_parts = resp.json() # list[str]
# Ejemplo: normalizar y ordenar para mostrar
ui_items = [{"key": bp, "label": bp.title()} for bp in body_parts]
ui_items.sort(key=lambda x: x["label"])
print("Partes del cuerpo disponibles:")
for item in ui_items:
print(f"- {item['label'}") Endpoint: Alternativas de Ejercicio
Devuelve hasta 10 ejercicios que coinciden con el mismo movimiento; si no hay ninguno, comparten el mismo músculo objetivo. Útil para sugerencias de intercambio en un constructor de entrenamientos.
Método HTTP: GET
URL de solicitud: https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives
Parámetros:
- id (número, requerido): 1
- equipment (cadena, opcional): barra
ejemplo de curl
Ejemplo de respuesta
[{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_2.gif","id":2,"name":"45\u00b0 side bend","target":"abs","videos":[{"title":"45 degree side bends","link":"https://youtu.be/pUXu_7H0y_o"},{"title":"Side Bend on 45-degree Hyper Extension - Bodyweight or Weighted","link":"https://youtu.be/IyCX-a9Lm_U"},{"title":"Dumbbell Side Bend - Core / Abs - Bodybuilding.com","link":"https://youtu.be/UUQHeBRE_Wo"}]},{"bodyPart":"waist","equipment":"body weight","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_3.gif","id":3,"name":"air bike","target":"abs","videos":[{"title":"Air Bike - Ab Exercises - Bodybuilding.com","link":"https://youtu.be/i6mPCVUrtNk"},{"title":"Air Bike Crunches","link":"https://youtu.be/3K9hMlalr60"},{"title":"Air cycling","link":"https://youtu.be/oyXoWU8j310"}]},{"bodyPart":"cintura","equipment":"peso corporal","gifUrl":" https://zyla-marketplace.s3.amazonaws.com/api-exercise/exercise_5.gif","id":5,"name":"toques alternos de talón","target":"abs","videos":[{"title":"Alternating Heel Touch | Bodyweight Home Workout Exercise","link":"https://youtu.be/5JyOU0smtMo"},{"title":"Cómo hacer…Campos clave que usarás:
- id, name: identificadores primarios para tu base de datos o interfaz de usuario.
- bodyPart, target: impulsan la categorización y etiquetado muscular.
- equipment: permite sustituciones basadas en el equipo disponible.
- gifUrl, videos: mejoran la experiencia del usuario con orientación visual.
Endpoint: Crear Programa
Inicia un programa y obtén la sesión de hoy de inmediato. Proporciona una rutina predefinida o un objetivo. La respuesta incluye metadatos de la sesión y ejercicios con series/repeticiones/reposo.
Método HTTP: POST
URL de solicitud: https://zylalabs.com/api/392/exercise-database-api/34185/create-program
Parámetros:
- request_body (cadena, requerido): {"client_id":"member-1","routine":"muscle_gain_4"}
ejemplo de curl
Ejemplo de respuesta
Persistir program_id y program_key para el miembro. Usa la sesión incrustada para renderizar el plan de hoy sin otra solicitud.
Endpoint: Entrenamiento de Hoy
Recupera la sesión de hoy para un programa existente. Devuelve ejercicios con series, rangos de repeticiones y orientación de descanso. Usa esto para reanudar el entrenamiento en la web o móvil después de la creación inicial del programa.
Método HTTP: GET
URL de solicitud: https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout
Parámetros:
- program (número, requerido): 1
- program_key (cadena, requerido): aaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa
ejemplo de curl
Ejemplo de respuesta
Campos importantes:
- week, day_name: contexto de visualización para la sesión.
- exercises[].sets, reps_min, reps_max, rest_seconds: prescripción central para el volumen de entrenamiento y ritmo.
- exercises[].weight_kg puede ser nulo inicialmente; se establece después de que el usuario registre la carga.
Patrones del mundo real que se envían rápido
- Incorporación: llama a la Lista de Partes del Cuerpo para renderizar chips seleccionables. Persiste las áreas de enfoque del usuario para personalizar las sugerencias de ejercicio.
- Interfaz de intercambio: cuando un usuario toca “Intercambiar”, llama a Alternativas de Ejercicio con el id del ejercicio actual y opcionalmente el equipo disponible para asegurar reemplazos viables.
- Programa instantáneo: POST Crear Programa después de la incorporación, luego muestra la sesión devuelta de inmediato. Almacena program_id/program_key en el perfil del usuario.
- Regreso diario: al abrir la aplicación, llama al Entrenamiento de Hoy con program y program_key para continuar donde lo dejaron.
- Ayuda visual: muestra gifUrl o el primer enlace de video junto a cada ejercicio para reducir la confusión y apoyar la forma adecuada.
Notas de implementación práctica
- Autenticación: envía Authorization: Bearer YOUR_API_KEY en cada solicitud.
- Cacheo: La Lista de Partes del Cuerpo es estable. Almacena en caché durante horas o días para reducir la latencia y evitar llamadas adicionales.
- Pesos nulos: Muchos campos de fuerza comienzan como nulos hasta que un usuario registra la carga; maneja esto con gracia y muestra cadenas de orientación como “Elige un peso que esté en el rango de repeticiones.”
- Medios: gifUrl y videos proporcionan referencias visuales rápidas; precarga los GIFs en Wi‑Fi para una experiencia de usuario más fluida.
- Suscripciones: la facturación es suscripción + cuota. El primer acceso a la API generalmente incluye una prueba de 7 días o 50 solicitudes para evaluación; verifica los detalles en la página de listado antes de realizar pruebas de carga.
Llamando desde un agente de IA a través de MCP
Si estás orquestando tareas con un agente de codificación de IA, puedes exponer esta API a través del endpoint MCP de Zyla. El servidor MCP está disponible en https://mcp.zylalabs.com/mcp?apikey=YOUR_API_KEY y funciona con clientes compatibles con MCP como Claude Code, Cursor y Windsurf. Consulta la documentación en MCP. Una vez conectado, tu agente puede invocar los mismos endpoints de la API de Base de Datos de Ejercicios con tu clave API gestionada de forma segura por la capa MCP.
Manejo de errores y resiliencia
- Validación de entrada: para Alternativas de Ejercicio, asegúrate de que el id sea un identificador numérico válido y pasa el equipo solo cuando realmente pretendas filtrar por él.
- Time-outs: usa time-outs del lado del cliente (por ejemplo, 10–20s) y reintentos para errores de red transitorios.
- Fallbacks elegantes: si el Entrenamiento de Hoy no está disponible (programa/program_key faltantes), dirige a los usuarios a Crear Programa y luego procede con la sesión devuelta.
Ejemplo de cableado de extremo a extremo
Flujo
- Obtén las partes del cuerpo una vez y renderiza como pestañas: cintura, piernas superiores, espalda, piernas inferiores, pecho, brazos superiores, cardio, hombros, brazos inferiores, cuello.
- Al seleccionar el usuario, permite que cree un programa (por ejemplo, muscle_gain_4). Almacena program_id y program_key.
- Carga la sesión de hoy y muestra las prescripciones: series, rangos de repeticiones y descanso.
- Ofrece “Intercambiar ejercicio.” Cuando se toque, llama a Alternativas de Ejercicio para mostrar opciones compatibles, filtrando por el equipo disponible si es aplicable.
Seguridad, claves y entornos
- Nunca codifiques en duro YOUR_API_KEY en aplicaciones cliente; proxy las llamadas a través de tu backend o usa inyección de entorno seguro en construcciones móviles.
- Configura el alcance por entorno (dev/staging/prod) para que tu equipo pueda probar contra una cuota de suscripción separada si es necesario.
Preguntas Frecuentes
-
¿Puedo obtener una lista de partes del cuerpo sin filtros?
Sí. Llama a GET https://zylalabs.com/api/392/exercise-database-api/309/list-of-body-parts con tu encabezado de autorización. Devuelve un array de cadenas.
-
¿Cómo encuentro sustitutos para un ejercicio dado?
Usa GET https://zylalabs.com/api/392/exercise-database-api/34184/exercise-alternatives con el parámetro id requerido y opcionalmente equipo para refinar los resultados.
-
¿Cómo genero un plan de entrenamiento para un usuario?
POST a https://zylalabs.com/api/392/exercise-database-api/34185/create-program con una cadena request_body que contenga al menos client_id y rutina. Persiste el program_id y program_key devueltos.
-
¿Cómo cargo el entrenamiento del día actual para un programa existente?
Llama a GET https://zylalabs.com/api/392/exercise-database-api/34186/today-s-workout con program y program_key. Recibirás ejercicios, series, rangos de repeticiones, descanso y medios.
-
¿Cuáles son los precios y términos de prueba?
La API de Base de Datos de Ejercicios utiliza un modelo de suscripción + cuota. La primera API generalmente incluye una prueba de 7 días o 50 solicitudes para evaluar. Consulta la página de la API para opciones de acceso y precios actuales.
¿Listo para conectar tu interfaz de usuario a una lista confiable de partes del cuerpo y enviar características ricas en ejercicios esta semana? Suscríbete ahora y obtén tu clave en la lista del mercado: Comienza la prueba de 7 días en la API de Base de Datos de Ejercicios.
