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, es, de, fr, pt, ja, hi, ar).

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