Nutzung der Economy API¶
Quantifizieren Sie die Laufeffizienz und erhalten Sie Trainingsstrategien, die die Geschwindigkeit pro Anstrengung verbessern.
Endpunkt¶
GET /api/v1/fitness/running-economyPOST /api/v1/fitness/running-economy/post
Parameter¶
| Name | Type | Erforderlich | In | Beschreibung |
|---|---|---|---|---|
pace_per_km | number (2.0-15.0) | Ja | Query/Body | Durchschnittliche Pace pro Kilometer (Minuten). |
heart_rate_avg | number (80-210) | Ja | Query/Body | Durchschnittlicher Herzfrequenzwert in bpm. |
vo2max | number (15-90) | Ja | Query/Body | Geschätzter/Wert für VO2 max. |
body_weight | number (35-250) | Ja | Query/Body | Körpergewicht in kg. |
lang | string | Nein | Query | Antwortsprache (en,es,de,fr,pt,ja,hi,ar). |
Warum diesen Endpunkt verwenden?¶
- Wandeln Sie Laufdaten in ein klares Effizienzsignal um.
- Vergleichen Sie die Leistung anhand von Percentilen und Banden.
- Erhalten Sie praktische Vorschläge für Verbesserungen.
Beispielanfrage¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/running-economy?pace_per_km=4.9&heart_rate_avg=162&vo2max=51&body_weight=73&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/running-economy/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"pace_per_km":5.6,"heart_rate_avg":171,"vo2max":45,"body_weight":80}'
Beispielantwort¶
Info
Das Beispiel für die Antwort dient nur zur Demonstration. Um die vollständige, Echtzeit- und potenziell reichhaltigere JSON-Struktur zu erhalten, senden Sie eine Live-Anfrage an diesen Endpunkt.
{
"pace_per_km": 4.9,
"heart_rate_avg_bpm": 162.0,
"vo2max_ml_kg_min": 51.0,
"body_weight_kg": 73.0,
"running_efficiency_score": 79,
"efficiency_band": {"band": "strong", "band_label": "Strong", "insight": "Strong economy profile with room for refinement."},
"economy_percentile": 79,
"economy_index": 33.2,
"efficiency_components": {"pace_component": 41.4, "heart_rate_component": 15.4, "aerobic_component": 39.0, "mass_penalty": 2.9},
"improvement_lever_suggestions": ["Use threshold intervals and aerobic volume consistency"],
"stimulus_focus": "Threshold + aerobic durability",
"confidence_score": 87,
"summary": "Running economy is strong with targeted gains available.",
"language": "en",
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "93027cd0f866757d", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "fitness_running_economy", "response_language": "en"}
}
Produktpositionierung¶
Eine differenzierte Funktion für Leistungsanalysen, Trainings-Apps und Produkte für Wettrennen.
Hinweis
pace_per_km erwartet das Format Minuten pro km, nicht die Geschwindigkeit in km/h.
Empfohlene Endpunkte¶
GET /api/v1/bmi- Bmi APIGET /api/v1/tdee- Tdee APIGET /api/v1/bmr- Bmr APIGET /api/v1/protein-calculator- Protein Calculator APIGET /api/v1/fitness/heart-rate-zones- Heart Rate Zones APIGET /api/v1/bodyfat- Bodyfat API