Heart Rate Zones API¶
Geben Sie Herzfrequenzzonen mit handlungsorientiertem Coaching-Kontext für Fettabbau, Ausdauer und Leistungsoptimierung zurück.
Endpoint¶
GET /api/v1/fitness/heart-rate-zonesPOST /api/v1/fitness/heart-rate-zones/post
Parameter¶
| Name | Type | Erforderlich | In | Beschreibung |
|---|---|---|---|---|
age | Integer (13-90) | Ja | Query/Body | Alter des Athleten in Jahren. |
resting_hr | Zahl (30-130) | Ja | Query/Body | Ruheherzfrequenz in bpm. |
goal | Zeichenkette | Ja | Query/Body | fat_loss,muscle_gain,maintenance,endurance,recomposition. |
max_hr | Zahl (120-230) | Nein | Query/Body | Maximale Herzfrequenz; wenn nicht angegeben, wird eine anhand des Alters basierte Schätzung verwendet. |
lang | Zeichenkette | Nein | Query | Antwortsprache (en,es,de,fr,pt,ja,hi,ar). |
Warum dieses Endpoint verwenden¶
- Bereitstellung von Trainingsbereiten Herzfrequenzzonen pro Benutzerprofil.
- Ausrichtung von Trainingsplänen auf Ziele und Bereitschaft.
- Unterstützung von Coaching-Automatisierungen mit konsistenter Logik für Zonen.
Beispielanfrage¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/heart-rate-zones?age=33&resting_hr=58&goal=endurance&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/heart-rate-zones/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"age":33,"resting_hr":58,"goal":"fat_loss","max_hr":188}'
Beispielantwort¶
Info
Das folgende Antwortbeispiel dient nur zu Demonstrationszwecken. Um die vollständige, Echtzeit- und potenziell reichhaltigere JSON-Struktur zu erhalten, führen Sie eine Live-Anfrage an dieses Endpoint.
{
"goal": "fat_loss",
"goal_label": "Fat Loss",
"age": 33,
"resting_hr_bpm": 58.0,
"max_hr_bpm": 188,
"max_hr_source": "provided",
"heart_rate_reserve_bpm": 130,
"zones": {
"zone_1": {"label": "Zone 1", "min_bpm": 123, "max_bpm": 136},
"zone_2": {"label": "Zone 2", "min_bpm": 136, "max_bpm": 149},
"zone_3": {"label": "Zone 3", "min_bpm": 149, "max_bpm": 162},
"zone_4": {"label": "Zone 4", "min_bpm": 162, "max_bpm": 175},
"zone_5": {"label": "Zone 5", "min_bpm": 175, "max_bpm": 188}
},
"fat_burn_zone": {"zone": "zone_2", "label": "Fat Burn Zone", "min_bpm": 136, "max_bpm": 149},
"vo2_optimization_zone": {"zone": "zone_4", "label": "VO2 Optimization Zone", "min_bpm": 162, "max_bpm": 175},
"threshold_zone": {"zone": "zone_4", "min_bpm": 162, "max_bpm": 175},
"anaerobic_power_zone": {"zone": "zone_5", "min_bpm": 175, "max_bpm": 188},
"readiness_signal": {"level": "high", "level_label": "High", "note": "Recovery indicators support quality intervals."},
"goal_session_guidance": ["2 threshold intervals", "1 long zone-2 block"],
"training_notes": {
"warmup": "Build progressively for 10-15 minutes.",
"cooldown": "Use 8-10 minutes low-intensity recovery.",
"zone_switching": "Transition gradually when moving between zones."
},
"summary": "Balanced zone strategy optimized for fat-loss efficiency.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "f6b9fb31d4f2a027",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "fitness_heart_rate_zones",
"response_language": "en"
}
}
Produktpositionierung¶
Ideal für vernetzte Fitness-Wearables, Coaching-Dashboards und Automatisierung des Ausdauertrainings.
Anmerkung
max_hr ist optional. Wenn nicht angegeben, schätzt die API die maximale Herzfrequenz anhand des Alters mit der Tanaka-Formel.
Empfohlene Endpoints¶
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/bodyfat- Bodyfat APIGET /api/v1/maintenance-calorie- Maintenance Calorie API