Aller au contenu

API de Récupération de la Dette de Sommeil

Estimez la dette de sommeil accumulée sur une fenêtre de 7 jours et renvoyez une prévision de récupération pour les workflows d'entraînement et de bien-être.

Point de terminaison

  • GET /api/v1/fitness/sleep-debt-recovery
  • POST /api/v1/fitness/sleep-debt-recovery/post

Paramètres

Nom Type Obligatoire In Description
actual_sleep_hours_7d chaîne Oui Requête/Corps Liste séparée par des virgules d'exactement 7 valeurs d'heures de sommeil.
baseline_sleep_need nombre (4-12) Oui Requête/Corps Besoin de sommeil de base quotidien en heures.
lang chaîne Non Requête Langue de la réponse (en,fr,es,de,pt,ja,hi,ar,bn,gu,id,it,ko,mr,nl,pa,pl,ro,ru,ta,te,th,tr,ur,vi,zh).

Exemple de requête

curl -X GET "https://api.hefitapi.com/api/v1/fitness/sleep-debt-recovery?actual_sleep_hours_7d=6.5,7,5.5,6,8,6,7&baseline_sleep_need=8&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/sleep-debt-recovery/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"actual_sleep_hours_7d":"6.5,7,5.5,6,8,6,7","baseline_sleep_need":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, en temps réel et potentiellement plus riche, effectuez une requête à cet endpoint.

{
  "actual_sleep_hours": [6.5, 7.0, 5.5, 6.0, 8.0, 6.0, 7.0],
  "baseline_sleep_need": 8.0,
  "sleep_debt": 10.0,
  "recovery_days_estimate": 5.0,
  "debt_level": "moderate",
  "debt_level_label": "Moderate sleep debt",
  "summary": "Moderate sleep debt detected. Sleep efficiency and recovery capability may be slightly impaired.",
  "recommendations": [
    "Consider a rest day or light technical session.",
    "Implement a pre-sleep wind-down routine (no screens 45 minutes before bed)."
  ],
  "language": "en",
  "_api_metadata_": {"endpoint_name": "sleep_debt_recovery", "response_language": "en"}
}

Localisation

Ce point de terminaison lit health_fitness_sleep_debt_recovery.json à partir des catalogues de langues pris en charge.

Points de terminaison recommandés