DCN API¶
Berechnen Sie den täglichen Kalorienbedarf mithilfe der Mifflin- oder Harris-Gleichung, eines Aktivitätsmultiplikators und einer Zielanpassung.
Endpoint¶
GET /api/v1/dcnPOST /api/v1/dcn/post
Parameter¶
| Name | Type | Erforderlich | In | Beschreibung |
|---|---|---|---|---|
age | Integer | Ja | Query/Body | Alter in Jahren. |
weight | Number | Ja | Query/Body | Gewicht in kg. |
height | Number | Ja | Query/Body | Größe in cm. |
gender | String (male,female) | Ja | Query/Body | Geschlecht. |
activity_level | String | Ja | Query/Body | sedentary,lightly_active,moderately_active,very_active,extra_active. |
goal | String | Nein | Query/Body | weight_loss,maintenance,weight_gain. |
equation | String | Nein | Query | mifflin oder harris. |
lang | String | Nein | Query | Antwortsprache (en,es,de,fr,pt,ja,hi,ar). |
Warum diesen Endpoint verwenden?¶
- Erstellen Sie robuste Empfehlungen für den Kalorienbedarf.
- Beibehalten Sie die Transparenz der Formeln für Compliance und Vertrauen.
- Verknüpfen Sie Energieziele mit Benutzerzielen in einem einzigen API-Aufruf.
Beispielanfrage¶
curl -X GET "https://api.hefitapi.com/api/v1/dcn?age=36&weight=81&height=177&gender=male&activity_level=moderately_active&goal=maintenance&equation=mifflin&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/dcn/post?equation=mifflin&lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"age":36,"weight":81,"height":177,"gender":"male","activity_level":"moderately_active","goal":"maintenance"}'
Beispielantwort¶
Info
Das folgende Beispiel dient nur zur Demonstration. Um die vollständige, aktuelle und möglicherweise reichhaltigere JSON-Struktur zu erhalten, senden Sie eine Live-Anfrage an diesen Endpoint.
{
"caloric_needs": {
"equation": "mifflin",
"goal": "maintenance",
"calories": "2762.15 kcal/day"
},
"daily_calorie_target_kcal": 2762.15,
"bmr_kcal_per_day": 1782.03,
"activity_multiplier": 1.55,
"profile": {
"age": 36,
"weight_kg": 81.0,
"height_cm": 177.0,
"gender": "male",
"activity_level": "moderately_active",
"goal": "maintenance",
"equation": "mifflin"
},
"energy_band": "high",
"energy_band_label": "High",
"risk_signal": "Higher intake precision required.",
"action_plan": ["Track trend weekly"],
"monitoring_plan": "Adjust if weight trend drifts.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "bc434f88c1116d94",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "dcn",
"response_language": "en"
}
}
Produktwert¶
Wertvoll für SaaS zur Ernährungsplanung, Patientenversorgungstools und Fitness-Coaching-Produkte mit zielbasierten Energiezielen.
Anmerkung
equation wird als Query-Parameter übergeben, auch wenn POST /dcn/post verwendet wird.
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