Aller au contenu

API de Plan d'Hydratation

Générez des recommandations personnalisées en matière d'hydratation en fonction du poids corporel, de la température ambiante et de la durée de l'entraînement.

Point de terminaison

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

Paramètres

Nom Type Obligatoire In Description
weight nombre (35-300) Oui Requête/Corps Poids corporel en kilogrammes.
temperature_c nombre (-10 à 55) Oui Requête/Corps Température ambiante en degrés Celsius.
training_minutes entier (0-360) Oui Requête/Corps Durée de l'entraînement quotidienne.
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

  • Personnaliser la planification de l'hydratation en fonction du climat et de la charge de travail.
  • Fournir des objectifs pour le sodium, le potassium et le magnésium.
  • Fournir un protocole d'apport spécifique dans le temps pour avant/pendant/après l'entraînement.

Commencer

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/hydration-plan?weight=78&temperature_c=31&training_minutes=75&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/hydration-plan/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"weight":78,"temperature_c":31,"training_minutes":75}'

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 à cet endpoint.

{
  "weight_kg": 78.0,
  "temperature_c": 31.0,
  "training_minutes": 75,
  "training_load": "moderate",
  "training_load_label": "Moderate",
  "heat_profile": "high",
  "heat_profile_label": "High",
  "hydration_plan": {
    "baseline_hydration_liters": 2.57,
    "workout_hydration_liters": 0.75,
    "heat_adjustment_liters": 1.35,
    "total_daily_target_liters": 4.67
  },
  "daily_hydration_baseline_liters": 2.57,
  "electrolyte_targets": {
    "sodium_mg": 1638,
    "potassium_mg": 504,
    "magnesium_mg": 116
  },
  "timing_protocol": {
    "pre_training": {"volume_liters": 0.51, "instruction": "Hydrate before session start."},
    "during_training": {"volume_liters": 0.72, "instruction": "Use steady fluid intake during training."},
    "post_training": {"volume_liters": 1.68, "instruction": "Rehydrate in the first recovery window."}
  },
  "adjustment_logic": "Increase fluid and sodium as heat and duration rise.",
  "scenario_guidance": ["Prioritize cooling and frequent sips"],
  "rapid_adjustment_rules": ["Add electrolytes for longer sessions"],
  "next_check_protocol": {"window_hours": 24, "metric": "hydration compliance"},
  "risk_flags": ["Heat stress risk elevated", "Electrolyte gap risk"],
  "summary": "Elevated hydration and electrolyte support advised.",
  "recommendations": [
    "Increase hydration volumes for moderate training load.",
    "Use pre, intra, and post-workout intake timing."
  ],
  "language": "en",
  "_enterprise": {
    "client": "Acme Health",
    "plan": "pro",
    "request_id": "fc6d8cc3f0b14fb2",
    "quota": 120,
    "usage_tracking": true
  },
  "_api_metadata_": {
    "endpoint_name": "fitness_hydration_plan",
    "response_language": "en"
  }
}

Positionnement du produit

Idéal pour les applications de sport, les appareils de bien-être et les systèmes de coaching d'entreprise qui ont besoin d'une automatisation de l'hydratation tenant compte du climat.

Note

training_minutes prend en charge 0-360; les valeurs en dehors de la plage renvoient une erreur HTTP 400.

Points de terminaison recommandés