Aller au contenu

API IBW

Calculer le poids corporel idéal en kg et lb avec une logique optionnelle ajustée pour les calculs de coaching et cliniques.

Point de terminaison

  • GET /api/v1/ibw
  • POST /api/v1/ibw/post

Paramètres

Nom Type Obligatoire Valeur Description
height nombre (>0) Oui Requête/Corps Hauteur en centimètres.
body_frame chaîne Oui Requête/Corps small, medium, large.
gender chaîne Oui Requête/Corps male ou female.
formula chaîne Non Requête hamwi (par défaut) ou devine.
lang chaîne Non Requête Langue de la réponse (en, es, de, fr, pt, ja, hi, ar).

Pourquoi utiliser ce point de terminaison

  • Standardiser l'estimation du poids corporel idéal dans les différents produits.
  • Fournir des résultats spécifiques aux formules pour les contextes cliniques et de remise en forme.
  • Ajouter de la précision et des conseils de suivi pour les objectifs de poids bruts.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/ibw?height=176&body_frame=medium&gender=male&formula=hamwi&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/ibw/post?formula=devine&lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"height":165,"body_frame":"small","gender":"female"}'

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 à cet endpoint.

{
  "ideal_weight": "69.42 kg",
  "formula": "Hamwi",
  "gender": "Male",
  "body_frame": "Medium",
  "ideal_weight_kg": 69.42,
  "ideal_weight_lb": 153.04,
  "height_cm": 176.0,
  "height_m": 1.76,
  "precision_band": "frame_adjusted",
  "precision_label": "Frame Adjusted",
  "risk_signal": "Reference target suitable for phased planning.",
  "action_plan": ["Set sustainable weekly target range"],
  "monitoring_plan": "Reassess with body composition and performance markers.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "146e3a98a9a8ec1c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "ibw",
    "response_language": "en"
  }
}

Positionnement du produit

Utile pour les formulaires d'admission, les plans de coaching numériques et les flux de travail de dépistage de santé nécessitant des estimations normalisées du poids corporel idéal.

Note

height, body_frame, et gender sont obligatoires pour les requêtes GET et POST.

Points de terminaison recommandés