Aller au contenu

API MND

Retourne les pourcentages de répartition des macronutriments, adaptés au niveau d'activité et aux objectifs de forme physique.

Point de terminaison

  • GET /api/v1/mnd
  • POST /api/v1/mnd/post

Paramètres

Nom Type Obligatoire In Description
activity_level chaîne de caractères Oui Requête/Corps sedentary,moderately_active,very_active.
body_composition_goal chaîne de caractères Oui Requête/Corps weight_loss,maintenance,muscle_gain.
dietary_preferences chaîne de caractères Oui Requête/Corps Contexte de préférence libre.
lang chaîne de caractères Non Requête Langue de la réponse (en,es,de,fr,pt,ja,hi,ar).

Pourquoi utiliser ce point de terminaison

  • Générer une recommandation immédiate de répartition des macronutriments sans longs formulaires.
  • Adapter la stratégie de répartition en fonction des résultats souhaités et des objectifs de forme physique.
  • Ajouter des notes de planification et de suivi pour une meilleure expérience utilisateur.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/mnd?activity_level=moderately_active&body_composition_goal=weight_loss&dietary_preferences=high%20protein&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/mnd/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"activity_level":"very_active","body_composition_goal":"muscle_gain","dietary_preferences":"balanced"}'

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.

{
  "carbohydrates": "45.0%",
  "proteins": "30.0%",
  "fats": "25.0%",
  "macro_split_percent": {
    "carbohydrates": 45.0,
    "proteins": 30.0,
    "fats": 25.0
  },
  "activity_level": "moderately_active",
  "body_composition_goal": "weight_loss",
  "dietary_preferences": "high protein",
  "macro_strategy_band": "balanced",
  "macro_strategy_label": "Balanced",
  "risk_signal": "Macro split is suitable for broad adherence.",
  "action_plan": ["Track response and adjust based on trend"],
  "monitoring_plan": "Review progress weekly and tune if needed.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "f1e48e4b4d3d6a9a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "mnd",
    "response_language": "en"
  }
}

Positionnement du produit

Un endpoint léger de planification des macronutriments pour l'onboarding, les flux de coaching et la personnalisation des programmes.

Note

activity_level et body_composition_goal sont des énumérations strictes ; les valeurs invalides renvoient une erreur HTTP 400.

Endpoints recommandés