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

واجهة برمجة تطبيقات لتحسين النوم

إنشاء تشخيصات لجودة النوم وبروتوكول تحسين عملي لتحسين التعافي الليلي.

نقطة النهاية

  • GET /api/v1/fitness/sleep-optimizer
  • POST /api/v1/fitness/sleep-optimizer/post

المعلمات

الاسم النوع مطلوب الإدخال الوصف
sleep_hours رقم (0-16) نعم استعلام/جسم المدة الكلية للنوم.
sleep_consistency_score عدد صحيح (0-100) نعم استعلام/جسم اتساق جدول النوم.
caffeine_intake_mg رقم (0-1200) نعم استعلام/جسم كمية الكافيين اليومية بالمليغرام.
screen_time_before_bed رقم (0-360) نعم استعلام/جسم مدة التعرض للشاشة قبل النوم.
lang سلسلة لا استعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

  • قياس جودة النوم والدورة اليومية في مخرج واحد.
  • الحصول على خطوات تحسين مستهدفة لتكرار السلوك بسرعة.
  • تحسين نتائج التعافي والتدريب من خلال تدخلات النوم.

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/fitness/sleep-optimizer?sleep_hours=6.9&sleep_consistency_score=62&caffeine_intake_mg=260&screen_time_before_bed=75&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/sleep-optimizer/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"sleep_hours":7.8,"sleep_consistency_score":84,"caffeine_intake_mg":120,"screen_time_before_bed":20}'

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

معلومات

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

{
  "sleep_hours": 6.9,
  "sleep_consistency_score": 62,
  "caffeine_intake_mg": 260.0,
  "screen_time_before_bed_minutes": 75.0,
  "sleep_quality_score": 55,
  "sleep_quality_band": {"band": "fragile", "band_label": "Fragile"},
  "circadian_alignment_insight": {"score": 58, "status": "misaligned", "status_label": "Misaligned", "insight": "Current schedule and habits reduce circadian stability."},
  "optimization_protocol": ["Reduce late caffeine and screen exposure", "Anchor wake time consistency"],
  "recovery_priority": "Stabilize routine before increasing training stress.",
  "next_adjustment_window_days": 3,
  "confidence_score": 77,
  "summary": "Sleep profile is fragile; near-term routine correction advised.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "56e5dbbb8de53ceb", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_sleep_optimizer", "response_language": "en"}
}

تحديد المنتج

ميزة مميزة لتطبيقات التعافي، والتدريب على الأداء، ومنصات السلوك الصحية.

ملاحظة

يتم قياس screen_time_before_bed بالدقائق.

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