Campos de la respuesta de la API FitExerciseDB

Cada ejercicio, en una lista o solo, tiene los mismos 16 campos. Los cinco obligatorios describen qué es el movimiento y qué músculo trabaja. El resto añade detalle de entrenamiento y de calorías.

Las cadenas exactas de bodyPart, target y equipment salen de los endpoints de taxonomía, descritos en la documentación de la API.

Solo id, name, bodyPart, target y equipment están garantizados. Modela los otros once como opcionales y anulables, y decide campo por campo qué significa un valor vacío en tu pantalla. Un tipo de TypeScript fiel a la API es así:

type Exercise = {
  id: string;                 // "0001", keep it a string
  name: string;
  bodyPart: string;
  target: string;
  equipment: string;
  category?: string | null;
  difficulty?: string | null;
  mechanic?: string | null;
  force?: string | null;
  met?: number | null;
  caloriesPerMinute?: number | null;
  averageCaloriesPerMinute?: number | null;
  averageCaloriesPerHour?: number | null;
  secondaryMuscles?: string[] | null;
  instructions?: string[] | null;
  language?: "en" | "fr" | "es" | "pt" | "zh" | "ja";
};

En los datos actuales, los 1324 ejercicios tienen los 16 campos rellenos, pero el esquema admite nulos, así que no cuentes con ello.

Dos reglas evitan la mayoría de los errores. Primero, oculta la sección de pasos cuando instructions sea null en lugar de mostrar una lista vacía. Segundo, comprueba met antes de llamar al endpoint de calorías: un ejercicio sin valor MET devuelve un error 422, no un número.

caloriesPerMinute es un valor almacenado para un peso corporal típico, pensado para mostrar rápido en una lista. averageCaloriesPerMinute lo repite con un nombre más claro, y averageCaloriesPerHour es ese valor por 60, redondeado (4,3 kcal por minuto pasan a 258 por hora). Ninguno sabe quién es tu usuario.

Para una estimación personal, pasa el peso y la duración a GET /v1/exercises/{id}/calories?bodyweightKg=80&minutes=30, que multiplica el MET del ejercicio por el peso y el tiempo. El cálculo y sus límites están en la guía de calorías MET. Los valores MET proceden del Compendium of Physical Activities, así que todo resultado es una estimación.

Las listas y la búsqueda comparten un mismo envoltorio: un array en data y un objeto pagination con page, pageSize y total. El tamaño de página por defecto es 50 y el máximo 100, así que los 1.324 ejercicios requieren 14 peticiones con el tamaño máximo. Algunos ejemplos de nuestra documentación muestran también un campo totalPages; calcúlalo tú para que tu código funcione en ambos casos:

{
  "data": [ { "id": "0001", "name": "3/4 Sit-up", "bodyPart": "Waist", "target": "Abs", "equipment": "Body Weight" } ],
  "pagination": { "page": 1, "pageSize": 50, "total": 1324 }
}

const pages = Math.ceil(total / pageSize); // 1324 / 100 = 14

La llamada a un solo ejercicio, GET /v1/exercises/{id}, devuelve los mismos 16 campos más un objeto _links al estilo de HAL. El enlace de calorías es una plantilla: el cliente rellena los dos parámetros en lugar de construir la URL a mano. Las listas no llevan _links.

"_links": {
  "self": { "href": "/v1/exercises/0001" },
  "related": { "href": "/v1/exercises/0001/related" },
  "calories": { "href": "/v1/exercises/0001/calories{?bodyweightKg,minutes}", "templated": true },
  "marketplacePreview": { "href": "/marketplace/preview/0001.gif" }
}

Añadir ?lang=fr (o es, pt, zh, ja) traduce name, bodyPart, target, equipment, secondaryMuscles e instructions, y pone language con el código que pediste. No toca id, los campos numéricos ni las cuatro etiquetas category, difficulty, mechanic y force, que se quedan como están. Así puedes guardar en caché los números una vez y volver a pedir solo los textos por idioma.

Cómo se elige el idioma, y por qué los términos de búsqueda deben seguir en inglés, se explica en la guía de búsqueda e idiomas. Para probarlo, explora la base de datos de ejercicios o lee la documentación. La respuesta no tiene un campo de imagen: consulta cómo comprar e incrustar los GIFs de ExerciseDB y GIF o video en las APIs de ejercicios.