Aller au contenu

API d'estimation des calories de l'entraînement

Retourne la plage d'estimation des calories brûlées et les diagnostics de confiance pour les séances d'entraînement.

Point de terminaison

  • GET /api/v1/fitness/workout-calorie-estimate
  • POST /api/v1/fitness/workout-calorie-estimate/post

Paramètres

Nom Type Obligatoire In Description
activity_type chaîne Oui Requête/Corps walking, jogging, running, cycling, swimming, strength_training, hiit, yoga, rowing, elliptical.
duration_min entier (1-360) Oui Requête/Corps Durée de la séance en minutes.
weight nombre (35-300) Oui Requête/Corps Poids du corps en kg.
intensity chaîne Oui Requête/Corps low, moderate, high, very_high.
lang chaîne Non Requête Langue de la réponse (en, fr, es, de, pt, ja, hi, ar, bn, gu, id, it, ko, mr, nl, pa, pl, ro, ru, ta, te, th, tr, ur, vi, zh).

Pourquoi utiliser ce point de terminaison

  • Produit une plage réaliste plutôt qu'une estimation unique.
  • Explique la confiance et l'incertitude pour améliorer la confiance de l'utilisateur.
  • Ajoute des règles de calibration pour une meilleure qualité d'estimation à long terme.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/workout-calorie-estimate?activity_type=cycling&duration_min=55&weight=78&intensity=moderate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/workout-calorie-estimate/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"activity_type":"hiit","duration_min":35,"weight":82,"intensity":"high"}'

Exemple de réponse

Info

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

{
  "activity_type": "cycling",
  "activity_label": "Cycling",
  "duration_min": 55,
  "weight_kg": 78.0,
  "intensity": "moderate",
  "intensity_label": "Moderate",
  "estimated_calorie_burn": {"central_kcal": 562, "lower_kcal": 471, "upper_kcal": 653},
  "confidence": {
    "score": 84,
    "level": "medium",
    "level_label": "Medium",
    "notes": ["Moderate confidence for this activity profile"]
  },
  "fueling_guidance": ["Use balanced pre/post fueling around session length"],
  "calibration_protocol": ["Calibrate estimate with wearable and trend data"],
  "range_application_rules": ["Use lower bound for conservative planning"],
  "quality_checks": [],
  "summary": "Useful directional burn estimate with medium confidence.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "4b16430a6aa5df6a", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_workout_calorie_estimate", "response_language": "en"}
}

Positionnement du produit

Idéal pour les applications de suivi de la forme physique, les outils de coaching et les produits d'analyse liés aux appareils portables.

Note

duration_min doit être compris entre 1 et 360.

Points de terminaison recommandés