Macro-Cycling-API¶
Erstellen Sie maßgeschneiderte Empfehlungen für Kalorien und Makronährstoffe, die auf das Ziel und das Aktivitätsprofil abgestimmt sind.
Endpunkt¶
GET /api/v1/fitness/macro-cyclingPOST /api/v1/fitness/macro-cycling/post
Parameter¶
| Name | Typ | Erforderlich | In | Beschreibung |
|---|---|---|---|---|
goal | string | Ja | Query/Body | fat_loss,muscle_gain,maintenance,endurance,recomposition. |
weight | number (35-300) | Ja | Query/Body | Körpergewicht in kg. |
activity_level | string | Ja | Query/Body | sedentary,light,moderate,active,athlete. |
lang | string | Nein | Query | Antwortsprache (en,es,de,fr,pt,ja,hi,ar). |
Warum diesen Endpunkt verwenden¶
- Unterstützung der Kalorien-Periodisierung in Coaching-Tools für Verbraucher und Profis.
- Trennung der Ernährungsziele für Trainings- und Ruhetage.
- Hinzufügen von Enterprise-Logikblöcken für Implementierung und Risikokontrolle.
Beispiel für eine Anfrage¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/macro-cycling?goal=fat_loss&weight=82&activity_level=moderate&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/macro-cycling/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"goal":"muscle_gain","weight":78,"activity_level":"active"}'
Beispiel für eine Antwort¶
Info
Das folgende Antwortbeispiel dient nur zu Demonstrationszwecken. Um die vollständige, Echtzeit- und potenziell reichhaltigere JSON-Struktur zu erhalten, senden Sie eine Live-Anfrage an diesen Endpunkt.
{
"goal": "fat_loss",
"goal_label": "Fat Loss",
"weight_kg": 82.0,
"activity_level": "moderate",
"activity_label": "Moderate",
"target_daily_calories": 2544,
"macro_cycling": {
"training_day": {
"calories": 2694,
"protein_g": 229,
"carbs_g": 242,
"fats_g": 90
},
"rest_day": {
"calories": 2394,
"protein_g": 203,
"carbs_g": 168,
"fats_g": 101
}
},
"adjustment_logic": "Lower calories on rest days while preserving protein adequacy.",
"implementation_suggestions": ["Keep weekly average aligned with goal"],
"risk_controls": ["Avoid aggressive day-to-day swings"],
"weekly_checkin_rules": ["Recalibrate if scale trend stalls for 2 weeks"],
"summary": "Macro cycling profile supports steady fat-loss progression.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "e4517ab38f59ed67",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "fitness_macro_cycling",
"response_language": "en"
}
}
Produktpositionierung¶
Ideal für fortschrittliche Ernährungsplaner, umfassende Coaching-Stacks und Leistungs-Apps.
Hinweis
goal und activity_level müssen aus unterstützten Enumerationen oder API-Antworten stammen, andernfalls wird ein HTTP 400-Fehler zurückgegeben.
Empfohlene Endpunkte¶
GET /api/v1/bmi- BMI-APIGET /api/v1/tdee- TDEE-APIGET /api/v1/bmr- BMR-APIGET /api/v1/protein-calculator- Proteinrechner-APIGET /api/v1/fitness/heart-rate-zones- Herzfrequenzzonen-APIGET /api/v1/bodyfat- Bodyfat-API