Zum Inhalt

Deload-Plan-API

Gibt an, ob ein Deload erforderlich ist, wie viel Volumen reduziert werden soll, und welche Deload-Struktur befolgt werden soll.

Endpoint

  • GET /api/v1/fitness/deload-plan
  • POST /api/v1/fitness/deload-plan/post

Parameter

Name Type Erforderlich In Beschreibung
weeks_trained Integer (1-104) Ja Query/Body Anzahl der kontinuierlichen Trainingswochen in Blöcken.
intensity_level String Ja Query/Body low,moderate,high,very_high,maximal.
accumulated_fatigue_score Integer (1-10) Ja Query/Body Subjektiver oder modellbasierter Müdigkeitswert.
lang String Nein Query Antwortsprache (en,es,de,fr,pt,ja,hi,ar).

Warum diesen Endpoint verwenden

  • Standardisierung der Deload-Entscheidungslogik über Teams hinweg.
  • Vermeidung von Überlastung und Verletzungen durch proaktive Lastkontrolle.
  • Operationalisierung von Periodisierungsregeln in Coaching-Apps.

Los geht's

Beispiel für eine Anfrage

curl -X GET "https://api.hefitapi.com/api/v1/fitness/deload-plan?weeks_trained=9&intensity_level=very_high&accumulated_fatigue_score=8&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/deload-plan/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"weeks_trained":9,"intensity_level":"very_high","accumulated_fatigue_score":8}'

Beispiel für eine Antwort

Info

Das obige Antwortbeispiel dient nur zu Demonstrationszwecken. Um die vollständige, Echtzeit- und potenziell reichhaltigere JSON-Struktur zu erhalten, senden Sie eine Anfrage an diesen Endpoint.

{
  "weeks_trained": 9,
  "intensity_level": "very_high",
  "intensity_level_label": "Very High",
  "accumulated_fatigue_score": 8,
  "deload_trigger_logic": {
    "trigger_score": 13,
    "trigger_level": "urgent",
    "trigger_level_label": "Urgent",
    "should_deload": true,
    "recommendation": "Immediate deload recommended."
  },
  "volume_reduction_percentage": {
    "suggested_percent": 45,
    "range_percent": {
      "min": 35,
      "max": 50
    },
    "band": "reset",
    "band_label": "Reset",
    "logic": "Severe fatigue state requires deep unload."
  },
  "sample_structure": ["3 low-volume sessions", "Mobility and recovery emphasis"],
  "intensity_adjustment": {
    "resistance_training": "Reduce load and RPE",
    "conditioning": "Zone 2 only"
  },
  "recovery_focus_priorities": ["Sleep extension", "Stress management"],
  "next_review_window_days": 14,
  "confidence_score": 91,
  "summary": "Deload now to protect adaptation quality.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "2d0b4d0108f9eaf8",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "fitness_deload_plan",
    "response_language": "en"
  }
}

Marktpositionierung

Ideal für Stärke-Coaching-SaaS und Leistungsplattformen, die eine zuverlässige Automatisierung der Müdigkeitsbewältigung benötigen.

Hinweis

intensity_level wird intern normalisiert (very high oder very-high wird zu very_high).

Empfohlene Endpunkte