Carbs-Rechner API¶
Berechnet die empfohlene Kohlenhydratzufuhr basierend auf Geschlecht, Alter, Körpermaßen und der durch Aktivität ermittelten TDEE (Total Daily Energy Expenditure).
Endpoint¶
GET /api/v1/carbs-calculatorPOST /api/v1/carbs-calculator/post
Parameter¶
| Name | Type | Erforderlich | In | Beschreibung |
|---|---|---|---|---|
sex | string (male,female) | Ja | Query/Body | Biologisches Geschlecht. |
age | number | Ja | Query/Body | Alter in Jahren. |
height | number | Ja | Query/Body | Körpergröße (in cm oder in Einheiten). |
weight | number | Ja | Query/Body | Gewicht (in kg oder lb Einheiten). |
unit | string (metric,imperial) | Nein | Query/Body | Einheitenauswahlmodus. Standardmäßig metric. |
activity_level | string | Ja | Query/Body | sedentary,lightly_active,moderately_active,very_active,extra_active. |
lang | string | Nein | Query | Antwortsprache (en,es,de,fr,pt,ja,hi,ar). |
Warum diesen Endpoint verwenden¶
- Wandeln Sie Profildaten in umsetzbare Kohlenhydratziele um.
- Ermöglichen Sie die periodische Kohlenhydratzufuhr für Trainingstage/Ruhetage.
- Verbessern Sie die Personalisierung von Ernährungsplänen in Coaching-Apps.
Beispielanfrage¶
curl -X GET "https://api.hefitapi.com/api/v1/carbs-calculator?sex=male&age=31&height=178&weight=82&unit=metric&activity_level=moderately_active&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/carbs-calculator/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"sex":"male","age":31,"height":178,"weight":82,"unit":"metric","activity_level":"moderately_active"}'
Beispielantwort¶
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 Endpoint.
{
"sex": "male",
"age": 31.0,
"height_cm": 178.0,
"weight_kg": 82.0,
"unit": "metric",
"activity_level": "moderately_active",
"tdee_kcal_per_day": 2870.16,
"usda_carbs_grams_range": [322.89, 466.4],
"recommended_carbs_g": 394.65,
"carb_band": "high",
"carb_band_label": "High",
"periodization_targets_g": {
"rest_day": 355.19,
"training_day": 434.12
},
"timing_guidance": ["Place larger carb portions around training"],
"action_plan": ["Prioritize complex carbs", "Track response weekly"],
"adjustment_rules": ["Reduce carbs if fat gain accelerates"],
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "2c8d9bd88b6f2f19",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "carbs_calculator",
"response_language": "en"
}
}
Produktnutzen¶
Ideal für SaaS-Anwendungen für Makroplanung, Tools zur Automatisierung der Ernährung und Produkte für Performance-Coaching.
Hinweis
activity_level muss genau mit einem der unterstützten Enum-Werte übereinstimmen.
Empfohlene Endpoints¶
GET /api/v1/net-carbs-calculator- Net Carbs Calculator APIGET /api/v1/6mwt-calculator- 6Mwt Calculator APIGET /api/v1/abi-calculator- Abi Calculator APIGET /api/v1/ava-calculator- Ava Calculator APIGET /api/v1/bri-calculator- Bri Calculator APIGET /api/v1/bsa-calculator- Bsa Calculator API