Aller au contenu

API de calcul des glucides

Calculer l'apport de glucides recommandé en fonction du sexe, de l'âge, des mesures corporelles et du TDEE (dépense énergétique quotidienne théorique) déterminé par l'activité physique.

Point de terminaison

  • GET /api/v1/carbs-calculator
  • POST /api/v1/carbs-calculator/post

Paramètres

Nom Type Obligatoire Dans Description
sex chaîne (male,female) Oui Requête/Corps Sexe biologique.
age nombre Oui Requête/Corps Âge en années.
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).
unit chaîne (metric,imperial) Non Requête/Corps Mode d'unité d'entrée. Valeur par défaut : metric.
activity_level chaîne Oui Requête/Corps sedentary,lightly_active,moderately_active,very_active,extra_active.
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

  • Transformer les données du profil en objectifs de glucides actionnables.
  • Permettre la périodisation des apports en glucides en fonction du jour d'entraînement/jour de repos.
  • Améliorer la personnalisation des plans nutritionnels dans les applications de coaching.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/carbs-calculator?sex=male&age=31&height=178&weight=82&unit=metric&activity_level=moderately_active&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/carbs-calculator/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sex":"male","age":31,"height":178,"weight":82,"unit":"metric","activity_level":"moderately_active"}'

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, réelle et potentiellement plus riche, effectuez une requête sur ce point de terminaison.

{
  "sex": "male",
  "age": 31.0,
  "height_cm": 178.0,
  "weight_kg": 82.0,
  "unit": "metric",
  "activity_level": "moderately_active",
  "tdee_kcal_per_day": 2870.16,
  "usda_carbs_grams_range": [322.89, 466.4],
  "recommended_carbs_g": 394.65,
  "carb_band": "high",
  "carb_band_label": "High",
  "periodization_targets_g": {
    "rest_day": 355.19,
    "training_day": 434.12
  },
  "timing_guidance": ["Place larger carb portions around training"],
  "action_plan": ["Prioritize complex carbs", "Track response weekly"],
  "adjustment_rules": ["Reduce carbs if fat gain accelerates"],
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "2c8d9bd88b6f2f19",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "carbs_calculator",
    "response_language": "en"
  }
}

Valeur du produit

Adapté aux logiciels SaaS de planification des macros, aux outils d'automatisation nutritionnelle et aux produits de coaching en matière de performance.

Note

activity_level doit correspondre exactement à l'une des valeurs enum prises en charge.

Points de terminaison recommandés