Champs de la réponse de l'API FitExerciseDB

Chaque exercice, dans une liste ou seul, a les mêmes 16 champs. Les cinq obligatoires décrivent le mouvement et le muscle travaillé. Les autres ajoutent le détail d'entraînement et de calories.

Les chaînes exactes de bodyPart, target et equipment viennent des points d'accès de taxonomie, décrits dans la documentation de l'API.

Seuls id, name, bodyPart, target et equipment sont garantis. Modélisez les onze autres comme facultatifs et nullables, puis décidez champ par champ ce qu'une valeur vide signifie pour votre écran. Un type TypeScript fidèle à l'API ressemble à ceci :

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";
};

Dans le jeu de données actuel, les 1 324 exercices ont les 16 champs renseignés, mais le schéma autorise les valeurs nulles : ne vous y fiez pas.

Deux règles évitent la plupart des bugs. D'abord, masquez la section des étapes quand instructions vaut null au lieu d'afficher une liste vide. Ensuite, vérifiez met avant d'appeler le point d'accès calories : un exercice sans valeur MET renvoie une erreur 422, pas un nombre.

caloriesPerMinute est une valeur stockée pour un poids moyen, pensée pour un affichage rapide dans une liste. averageCaloriesPerMinute la répète sous un nom plus parlant, et averageCaloriesPerHour vaut cette valeur fois 60, arrondie (4,3 kcal par minute donnent 258 par heure). Aucune ne sait qui est votre utilisateur.

Pour une estimation personnelle, passez le poids et la durée à GET /v1/exercises/{id}/calories?bodyweightKg=80&minutes=30, qui multiplie le MET de l'exercice par le poids et le temps. Le calcul et ses limites sont détaillés dans le guide des calories MET. Les valeurs MET viennent du Compendium of Physical Activities : toute valeur reste une estimation.

Les listes et la recherche partagent une même enveloppe : un tableau dans data et un objet pagination avec page, pageSize et total. La taille de page par défaut est 50, le maximum 100, donc les 1 324 exercices demandent 14 requêtes à la taille maximale. Certains exemples de notre documentation montrent aussi un champ totalPages ; calculez-le vous-même pour que votre code marche dans les deux cas :

{
  "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

L'appel sur un seul exercice, GET /v1/exercises/{id}, renvoie les mêmes 16 champs plus un objet _links dans le style de HAL. Le lien calories est un modèle : le client remplit les deux paramètres au lieu de construire l'URL à la main. Les listes n'ont pas de _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" }
}

Ajouter ?lang=fr (ou es, pt, zh, ja) traduit name, bodyPart, target, equipment, secondaryMuscles et instructions, et met language au code demandé. Il ne touche ni à id, ni aux champs numériques, ni aux quatre libellés category, difficulty, mechanic et force, qui restent tels quels. Vous pouvez donc mettre les nombres en cache une fois et ne recharger que les textes par langue.

La façon dont la langue est choisie, et pourquoi les termes de recherche restent en anglais, fait l'objet du guide recherche et langues. Pour tout essayer, parcourez la base d'exercices ou lisez la documentation. La réponse n'a pas de champ image : voir acheter et intégrer les GIFs ExerciseDB et GIF ou vidéo dans les API d'exercices.