API zur Schätzung der Kalorienverbrennung beim Training¶
Gibt den geschätzten Kalorienverbrauch sowie Diagnoseinformationen für Trainingseinheiten zurück.
Endpunkt¶
GET /api/v1/fitness/workout-calorie-estimatePOST /api/v1/fitness/workout-calorie-estimate/post
Parameter¶
| Name | Type | Erforderlich | In | Beschreibung |
|---|---|---|---|---|
activity_type | string | Ja | Query/Body | walking,jogging,running,cycling,swimming,strength_training,hiit,yoga,rowing,elliptical. |
duration_min | integer (1-360) | Ja | Query/Body | Dauer der Sitzung in Minuten. |
weight | number (35-300) | Ja | Query/Body | Körpergewicht in kg. |
intensity | string | Ja | Query/Body | low,moderate,high,very_high. |
lang | string | Nein | Query | Antwortsprache (en,es,de,fr,pt,ja,hi,ar). |
Warum diesen Endpunkt verwenden¶
- Erzeugt einen realistischen Bereich statt einer einzelnen Schätzung.
- Erklärt die Konfidenz und Unsicherheit, um das Vertrauen der Benutzer zu stärken.
- Fügt Kalibrierungsregeln hinzu, um die Qualität der langfristigen Schätzungen zu verbessern.
Beispielanfrage¶
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"}'
Beispielantwort¶
Info
Das folgende Antwortbeispiel dient nur zu Demonstrationszwecken. Um die vollständige, Echtzeit- und möglicherweise reichhaltigere JSON-Struktur zu erhalten, senden Sie eine Live-Anfrage an diesen Endpunkt.
{
"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"}
}
Produktpositionierung¶
Ideal für Fitness-Tracking-Apps, Coaching-Tools und Wearable-verbundene Analyseprodukte.
Hinweis
duration_min muss zwischen 1 und 360 liegen.
Empfohlene Endpunkte¶
GET /api/v1/maintenance-calorie- API zur Aufrechterhaltung des KalorienbedarfsGET /api/v1/meal-calorie-calculator- API zur Berechnung der Kalorien aus MahlzeitenGET /api/v1/fitness/neat-estimate- API zur Schätzung des Neat-WertsGET /api/v1/fitness/vo2max-estimate- API zur Schätzung des Vo2Max-WertsGET /api/v1/bmi- API für den BMIGET /api/v1/tdee- API für den TDEE