Aller au contenu

API DCN

Calculez l'objectif calorique quotidien à l'aide de l'équation de Mifflin ou de Harris, d'un multiplicateur d'activité et d'un ajustement de l'objectif.

Point de terminaison

  • GET /api/v1/dcn
  • POST /api/v1/dcn/post

Paramètres

Nom Type Obligatoire In Description
age entier Oui Query/Body Âge en années.
weight nombre Oui Query/Body Poids en kg.
height nombre Oui Query/Body Taille en cm.
gender chaîne (male,female) Oui Query/Body Sexe biologique.
activity_level chaîne Oui Query/Body sedentary,lightly_active,moderately_active,very_active,extra_active.
goal chaîne Non Query/Body weight_loss,maintenance,weight_gain.
equation chaîne Non Query mifflin ou harris.
lang chaîne Non Query Langue de la réponse (en,es,de,fr,pt,ja,hi,ar).

Pourquoi utiliser ce point de terminaison

  • Développez des recommandations caloriques robustes.
  • Maintenez la transparence des formules pour la conformité et la confiance.
  • Liez les objectifs d'énergie aux objectifs de l'utilisateur en une seule requête API.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/dcn?age=36&weight=81&height=177&gender=male&activity_level=moderately_active&goal=maintenance&equation=mifflin&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/dcn/post?equation=mifflin&lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":36,"weight":81,"height":177,"gender":"male","activity_level":"moderately_active","goal":"maintenance"}'

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

{
  "caloric_needs": {
    "equation": "mifflin",
    "goal": "maintenance",
    "calories": "2762.15 kcal/day"
  },
  "daily_calorie_target_kcal": 2762.15,
  "bmr_kcal_per_day": 1782.03,
  "activity_multiplier": 1.55,
  "profile": {
    "age": 36,
    "weight_kg": 81.0,
    "height_cm": 177.0,
    "gender": "male",
    "activity_level": "moderately_active",
    "goal": "maintenance",
    "equation": "mifflin"
  },
  "energy_band": "high",
  "energy_band_label": "High",
  "risk_signal": "Higher intake precision required.",
  "action_plan": ["Track trend weekly"],
  "monitoring_plan": "Adjust if weight trend drifts.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "bc434f88c1116d94",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "dcn",
    "response_language": "en"
  }
}

Valeur du produit

Utile pour la planification nutritionnelle SaaS, les outils de soins aux patients et les produits de coaching sportif avec des objectifs d'énergie basés sur des objectifs.

Note

equation est passé en tant que paramètre de requête même pour POST /dcn/post.

Points de terminaison recommandés