Zum Inhalt

Vorhersage-API für Körperzusammensetzung

Schätzung der erwarteten Fettverlust- vs. Muskelaufbau-Trajektorie und der Wahrscheinlichkeit eines erfolgreichen Umbaus, einschließlich Projektionsblöcken von 4/8/12 Wochen.

Endpunkt

  • GET /api/v1/fitness/body-recomp-forecast
  • POST /api/v1/fitness/body-recomp-forecast/post

Parameter

Name Typ Erforderlich In Beschreibung
current_weight Zahl (35-300) Ja Abfrage/Körper Aktuelles Körpergewicht in kg.
body_fat_percentage Zahl (5-60) Ja Abfrage/Körper Aktueller Fettanteil in Prozent.
calorie_intake Zahl (800-6000) Ja Abfrage/Körper Durchschnittliche tägliche Nahrungsaufnahme.
protein_intake Zahl (40-450) Ja Abfrage/Körper Täglicher Proteinbedarf in Gramm.
training_days Integer (0-7) Ja Abfrage/Körper Anzahl der Widerstandstrainingstage pro Woche.
experience_level Zeichenkette Ja Abfrage/Körper beginner,intermediate,advanced,elite.
lang Zeichenkette Nein Abfrage Antwortsprache (en,es,de,fr,pt,ja,hi,ar).

Warum diesen Endpunkt verwenden

  • Um statische Nahrungs-/Trainingsdaten in prognostizierte Umbausergebnisse umzuwandeln.
  • Um Benutzer nach Wahrscheinlichkeit für einen Umbau zu priorisieren, um Coaching-Interventionen zu ermöglichen.
  • Um eine zeitliche Übersicht zu bieten, um die Einhaltung und Bindung zu verbessern.

Jetzt starten

Beispielanfrage

curl -X GET "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast?current_weight=84&body_fat_percentage=24&calorie_intake=2350&protein_intake=165&training_days=4&experience_level=intermediate&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/body-recomp-forecast/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{
    "current_weight": 84,
    "body_fat_percentage": 24,
    "calorie_intake": 2350,
    "protein_intake": 165,
    "training_days": 4,
    "experience_level": "intermediate"
  }'

Beispielantwort

Info

Das folgende Antwortbeispiel dient nur zur Demonstration. Um die vollständige, aktuelle und möglicherweise detailliertere JSON-Struktur zu erhalten, senden Sie eine Live-Anfrage an diesen Endpunkt.

{
  "current_weight_kg": 84.0,
  "body_fat_percentage": 24.0,
  "calorie_intake": 2350,
  "protein_intake_g": 165.0,
  "training_days": 4,
  "experience_level": "intermediate",
  "experience_level_label": "Intermediate",
  "estimated_fat_loss_vs_muscle_gain_ratio": {
    "fat_loss_kg_per_week": 0.23,
    "muscle_gain_kg_per_week": 0.13,
    "fat_to_muscle_ratio": 1.77,
    "ratio_label": "balanced_recomp",
    "ratio_label_text": "Balanced recomp"
  },
  "recomp_probability_score": {
    "score": 73,
    "band": "moderate",
    "band_label": "Moderate",
    "insight": "Good potential with consistency."
  },
  "timeline_projection": [
    {
      "week": 4,
      "projected_weight_kg": 83.6,
      "projected_body_fat_percent": 23.2,
      "estimated_fat_mass_change_kg": -0.92,
      "estimated_lean_mass_change_kg": 0.52
    }
  ],
  "strategy_adjustment_advice": ["Keep protein high", "Maintain progressive overload"],
  "metabolic_context": {
    "estimated_maintenance_calories": 2720,
    "daily_energy_gap": -370,
    "protein_g_per_kg": 1.96
  },
  "confidence_score": 84,
  "summary": "Consistent execution can deliver measurable recomposition.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "4b2ad1f68d3dc50a",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "api_name": "Health Fitness API by Dakidarts®",
    "endpoint_name": "fitness_body_recomp_forecast",
    "response_language": "en"
  }
}

Marktpositionierung

Ideal für hochinteraktive Coaching-Plattformen und Premium-Fitnessprodukte, bei denen Benutzer eine sichtbare, auf Wahrscheinlichkeiten basierende Fortschrittsvorhersage benötigen.

Hinweis

Die Validierung ist streng für alle Werte innerhalb des vorgegebenen Bereichs (Gewicht, Körperfett, Kalorien, Protein und Trainingstage).

Empfohlene Endpunkte