انتقل إلى المحتوى

واجهة برمجة تطبيقات تقييم التعافي

إنشاء تقييم يومي لجاهزية التعافي وخطة عمل بناءً على المؤشرات الحيوية الأساسية للتعافي.

نقطة النهاية

  • GET /api/v1/fitness/recovery-score
  • POST /api/v1/fitness/recovery-score/post

المعلمات

الاسم النوع مطلوب In الوصف
sleep_hours رقم (0-16) نعم استعلام/جسم مدة النوم بالساعات.
resting_hr رقم (30-120) نعم استعلام/جسم معدل ضربات القلب أثناء الراحة (بالنبض في الدقيقة).
hrv رقم (10-200) نعم استعلام/جسم HRV (معدل النبض المتسارع) بالمللي ثانية.
muscle_soreness رقم (0-10) نعم استعلام/جسم تقييم مستوى الألم.
lang سلسلة لا استعلام لغة الاستجابة (health-fitness-longevity-score-api, health-fitness-muscle-recovery-timeline-api, health-fitness-sedentary-risk-score-api, health-fitness-bmi-api, health-fitness-tdee-api, health-fitness-bmr-api).

لماذا تستخدم هذه نقطة النهاية

  • إنشاء توصيات تدريب مدفوعة بالجاهزية يوميًا.
  • اكتشاف علامات التحذير من عدم التعافي قبل حدوث انخفاض في الأداء.
  • تزويد سير العمل التلقائي بقرارات منظمة.

ابدأ الآن

مثال على الطلب

curl -X GET "https://api.hefitapi.com/api/v1/fitness/recovery-score?sleep_hours=7.1&resting_hr=59&hrv=66&muscle_soreness=4.2&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/recovery-score/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sleep_hours":6.3,"resting_hr":68,"hrv":44,"muscle_soreness":6.8}'

مثال على الاستجابة

معلومات

مثال الاستجابة أدناه هو للأغراض التوضيحية فقط. للحصول على الهيكل الكامل وواقعي وفي الوقت الفعلي وربما أكثر ثراءً، قم بإرسال طلب إلى هذه نقطة النهاية.

{
  "readiness_score": 73,
  "readiness_band": "ready",
  "readiness_label": "Ready",
  "recovery_summary": "Training can proceed with moderate quality focus.",
  "input_signals": {"sleep_hours": 7.1, "resting_hr_bpm": 59.0, "hrv_ms": 66.0, "muscle_soreness": 4.2},
  "component_scores": {"sleep_score": 85, "resting_hr_score": 69, "hrv_score": 58, "soreness_score": 58},
  "recovery_recommendations": ["Proceed with quality session while monitoring fatigue"],
  "decision_protocol": {"today": "train", "intensity": "moderate_high"},
  "today_priority_actions": ["Warm up thoroughly", "Hydration and post-session recovery"],
  "tomorrow_readiness_focus": ["Sleep consistency", "Low-stress recovery work"],
  "red_flag_escalations": [],
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "7f2552f2fb7ad884", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_recovery_score", "response_language": "en"}
}

تحديد المنتج

مثالي لوحدات تحكم التعافي، ومحركات تنظيم التدريب التلقائي، ومنصات التدريب.

ملاحظة

يجب تحديد muscle_soreness ويجب أن يكون ضمن النطاق 0-10.

نقاط النهاية الموصى بها