Aller au contenu

Zones de fréquence cardiaque

Récupérez les zones de fréquence cardiaque avec un contexte de coaching actionnable pour la perte de poids, l'endurance et l'optimisation des performances.

Point de terminaison

  • GET /api/v1/fitness/heart-rate-zones
  • POST /api/v1/fitness/heart-rate-zones/post

Paramètres

Nom Type Obligatoire Valeur Description
age entier (13-90) Oui Requête/Corps Âge de l'athlète en années.
resting_hr nombre (30-130) Oui Requête/Corps Fréquence cardiaque au repos en bpm.
goal chaîne Oui Requête/Corps fat_loss,muscle_gain,maintenance,endurance,recomposition.
max_hr nombre (120-230) Non Requête/Corps Fréquence cardiaque maximale; si omis, une estimation basée sur l'âge est utilisée (formule de Tanaka).
lang chaîne Non Requête Langue de la réponse (en,es,de,fr,pt,ja,hi,ar).

Pourquoi utiliser ce point de terminaison

  • Fournir des zones de fréquence cardiaque prêtes à l'emploi en fonction du profil de chaque utilisateur.
  • Aligner les prescriptions de séance avec les objectifs et la préparation.
  • Faciliter les automatisations de coaching grâce à une logique de zone cohérente.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/heart-rate-zones?age=33&resting_hr=58&goal=endurance&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/heart-rate-zones/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":33,"resting_hr":58,"goal":"fat_loss","max_hr":188}'

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, en temps réel et potentiellement plus riche, effectuez une requête réelle vers cet endpoint.

{
  "goal": "fat_loss",
  "goal_label": "Fat Loss",
  "age": 33,
  "resting_hr_bpm": 58.0,
  "max_hr_bpm": 188,
  "max_hr_source": "provided",
  "heart_rate_reserve_bpm": 130,
  "zones": {
    "zone_1": {"label": "Zone 1", "min_bpm": 123, "max_bpm": 136},
    "zone_2": {"label": "Zone 2", "min_bpm": 136, "max_bpm": 149},
    "zone_3": {"label": "Zone 3", "min_bpm": 149, "max_bpm": 162},
    "zone_4": {"label": "Zone 4", "min_bpm": 162, "max_bpm": 175},
    "zone_5": {"label": "Zone 5", "min_bpm": 175, "max_bpm": 188}
  },
  "fat_burn_zone": {"zone": "zone_2", "label": "Fat Burn Zone", "min_bpm": 136, "max_bpm": 149},
  "vo2_optimization_zone": {"zone": "zone_4", "label": "VO2 Optimization Zone", "min_bpm": 162, "max_bpm": 175},
  "threshold_zone": {"zone": "zone_4", "min_bpm": 162, "max_bpm": 175},
  "anaerobic_power_zone": {"zone": "zone_5", "min_bpm": 175, "max_bpm": 188},
  "readiness_signal": {"level": "high", "level_label": "High", "note": "Recovery indicators support quality intervals."},
  "goal_session_guidance": ["2 threshold intervals", "1 long zone-2 block"],
  "training_notes": {
    "warmup": "Build progressively for 10-15 minutes.",
    "cooldown": "Use 8-10 minutes low-intensity recovery.",
    "zone_switching": "Transition gradually when moving between zones."
  },
  "summary": "Balanced zone strategy optimized for fat-loss efficiency.",
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "f6b9fb31d4f2a027",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "fitness_heart_rate_zones",
    "response_language": "en"
  }
}

Positionnement du produit

Idéal pour les appareils de fitness connectés, les tableaux de bord de coaching et l'automatisation de l'entraînement en endurance.

Note

max_hr est facultatif. Si absent, l'API estime la fréquence cardiaque maximale à partir de l'âge à l'aide de la formule de Tanaka.

Points de terminaison recommandés