Aller au contenu

API du plan de décharge

Indique si une décharge est nécessaire, la quantité de volume à réduire, et la structure de décharge à suivre.

Point de terminaison

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

Paramètres

Nom Type Obligatoire In Description
weeks_trained entier (1-104) Oui Requête/Corps Nombre de semaines de formation continues.
intensity_level chaîne Oui Requête/Corps low,moderate,high,very_high,maximal.
accumulated_fatigue_score entier (1-10) Oui Requête/Corps Score de fatigue subjectif ou basé sur le modèle.
lang chaîne Non Requête Langue de la réponse (en,es,de,fr,pt,ja,hi,ar).

Pourquoi utiliser cet endpoint

  • Standardiser la logique de décision concernant les décharges à travers les équipes.
  • Prévenir les efforts excessifs et les blessures grâce au contrôle proactif de la charge.
  • Mettre en œuvre les règles de périodisation dans les applications d'entraînement.

Commencer

Exemple de requête

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}'

Exemple de réponse

Info

L'exemple de réponse ci-dessous est uniquement à des fins de démonstration. Pour obtenir la structure JSON complète, réelle et potentiellement plus détaillée, effectuez une requête sur cet 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"
  }
}

Positionnement sur le marché

Excellent pour les SaaS et les plateformes de performance axées sur le coaching en force qui ont besoin d'une automatisation fiable de la gestion de la fatigue.

Note

intensity_level est normalisé en interne (very high ou very-high devient very_high).

Endpoints recommandés