Aller au contenu

API Karvonen

Fournir des directives précises pour la cible de BPM lors des séances de cardio avec un contrôle de l'intensité basé sur la réserve.

Point de terminaison

  • GET /api/v1/karvonen
  • POST /api/v1/karvonen/post

Paramètres

Nom Type Obligatoire In Description
age entier (>0) Oui Requête/Corps Âge en années.
rhr entier (>0) Oui Requête/Corps Fréquence cardiaque au repos en BPM.
intensity nombre (10-100) Oui Requête/Corps Pourcentage de l'intensité cible de l'entraînement.
mhr entier (>0) Non Requête/Corps Fréquence cardiaque maximale; si omis, l'API utilise 220 - age.
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

  • Utiliser des cibles de fréquence cardiaque basées sur la réserve au lieu des zones génériques.
  • Ajuster la conception de la séance pour les zones de récupération, aérobique, seuil et HIIT.
  • Ajouter une méthode mathématique transparente pour la zone cible aux applications cardio pour les consommateurs.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/karvonen?age=35&rhr=58&intensity=72&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/karvonen/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"age":35,"rhr":58,"mhr":188,"intensity":78}'

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.

{
  "age": 35,
  "resting_heart_rate_bpm": 58,
  "maximum_heart_rate_bpm": 185,
  "used_default_max_hr": true,
  "heart_rate_reserve_bpm": 127,
  "intensity_percent": 72.0,
  "target_heart_rate_bpm": 149.44,
  "training_zone_range_bpm": {
    "min": 143.09,
    "max": 155.79
  },
  "intensity_band": "aerobic",
  "intensity_band_label": "Aerobic",
  "risk_signal": "Sustainable zone for base-building sessions.",
  "action_plan": ["Use longer steady-state intervals"],
  "monitoring_plan": "Track drift and perceived exertion each session.",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "dd67b47d2223915c",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "karvonen",
    "response_language": "en"
  }
}

Positionnement du produit

Excellent pour les applications de résistance, les tableaux de bord d'entraînement et les plateformes de salles de sport qui nécessitent une automatisation de la cible de BPM reproductible.

Note

Si mhr est omis, la fréquence cardiaque maximale par défaut est 220 - age.

Points de terminaison recommandés