Aller au contenu

API FFMI

Calculez les métriques FFMI avec une sortie formatée facultative et un support pour les unités de mesure, pour les entrées en unités métriques ou impériales.

Point d'extrémité

  • GET /api/v1/ffmi
  • POST /api/v1/ffmi/post

Paramètres

Nom Type Obligatoire In Description
sex chaîne (male,female) Oui Requête/Corps Sexe biologique.
height nombre Oui Requête/Corps Taille (unité métrique, unité impériale).
weight nombre Oui Requête/Corps Poids (unité métrique, unité impériale).
body_fat nombre Oui Requête/Corps Pourcentage de graisse corporelle.
unit chaîne (metric,imperial) Non Requête/Corps Mode d'entrée. Valeur par défaut : metric.
format chaîne (yes,no) Non Requête/Corps Interrupteur de formatage de la sortie.
lang chaîne Non Requête Langue de la réponse (en,es,de,fr,pt,ja,hi,ar).

Pourquoi utiliser cet point d'extrémité

  • Ajouter une notation de qualité de la masse maigre aux produits de composition corporelle.
  • Comparer FFMI brut vs. normalisé pour une évaluation équitable.
  • Permettre des informations sur les segments d'athlètes avec des plages spécifiques au sexe.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/ffmi?sex=male&height=178&weight=82&body_fat=16&unit=metric&format=yes&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/ffmi/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","height":178,"weight":82,"body_fat":16,"unit":"metric","format":"yes"}'

Exemple de réponse

Info

L'exemple de réponse ci-dessous est uniquement à des fins de démonstration. Pour obtenir la structure JSON complète, en temps réel et potentiellement plus riche, effectuez une requête sur cet point d'extrémité.

{
  "FFMI": "19.38 kg/m2",
  "Normalized FFMI": "19.51 kg/m2",
  "Fat-free mass": "68.88 kg",
  "Total body fat": "13.12 kg",
  "Sex": "male",
  "Unit": "metric",
  "ffmi_value": 19.38,
  "normalized_ffmi_value": 19.51,
  "fat_free_mass_kg": 68.88,
  "total_body_fat_kg": 13.12,
  "ffmi_band": "standard",
  "ffmi_band_label": "Standard",
  "risk_signal": "Lean mass status is within expected range.",
  "action_plan": ["Progress overload gradually"],
  "monitoring_plan": "Track every mesocycle.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "de948be84a08433f",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "ffmi",
    "response_language": "en"
  }
}

Positionnement commercial

Parfait pour les analyses avancées de la composition corporelle, les produits d'entraînement en force et les piles de suivi des athlètes.

Note

format=no renvoie une présentation numérique non-chaîne pour les champs de données de FFMI de premier niveau.

Points d'extrémité recommandés