تحليل واجهة برمجة التطبيقات (API) للتحقق الأسبوعي¶
حوّل إشارات الوزن والقوة والتعافي والالتزام الأسبوعية إلى قرار قابل للتنفيذ بشأن التقدم.
نقطة النهاية¶
GET /api/v1/fitness/weekly-checkin-analysisPOST /api/v1/fitness/weekly-checkin-analysis/post
المعلمات¶
| الاسم | النوع | مطلوب | In | الوصف |
|---|---|---|---|---|
weight_change | رقم (من -10 إلى 10) | نعم | الاستعلام/الجسم | التغيير الأسبوعي في الوزن بالكيلوغرام. |
strength_change | رقم (من -30 إلى 30) | نعم | الاستعلام/الجسم | النسبة المئوية للتغيير في القوة أسبوعيًا. |
recovery_score_avg | رقم (من 0 إلى 100) | نعم | الاستعلام/الجسم | متوسط درجة التعافي. |
calorie_adherence_percent | رقم (من 0 إلى 150) | نعم | الاستعلام/الجسم | نسبة الالتزام بالتغذية. |
lang | سلسلة | لا | الاستعلام | لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar). |
لماذا استخدام هذه نقطة النهاية¶
- توحيد قرارات التحقق الأسبوعي على نطاق واسع.
- الكشف التلقائي عن علامات التدخل.
- تحسين الاتساق في التدريب من خلال تسجيل الزخم.
مثال على الطلب¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/weekly-checkin-analysis?weight_change=-0.6&strength_change=1.8&recovery_score_avg=71&calorie_adherence_percent=88&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/weekly-checkin-analysis/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"weight_change":-1.3,"strength_change":-2.4,"recovery_score_avg":54,"calorie_adherence_percent":72}'
مثال على الاستجابة¶
معلومات
مثال الاستجابة أدناه مخصص للأغراض التوضيحية فقط. للحصول على هيكل JSON الكامل، في الوقت الفعلي، وربما أكثر ثراءً، قم بإرسال طلب حقيقي إلى هذه نقطة النهاية.
{
"weight_change_kg": -0.6,
"strength_change_percent": 1.8,
"recovery_score_avg": 71.0,
"calorie_adherence_percent": 88.0,
"progress_interpretation": {"status": "on_track", "status_label": "On Track", "insight": "Current trend supports target progress."},
"adjustment_recommendations": ["Maintain current structure and monitor consistency"],
"weekly_priority_protocol": {"focus": "execution consistency"},
"next_week_focus": ["Preserve recovery and progressive overload"],
"intervention_matrix_flags": [],
"review_schedule": {"next_checkin_days": 7},
"momentum_rating": {"score": 83, "rating": "high", "rating_label": "High", "summary": "Momentum is strong and stable."},
"language": "en",
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f359506a436d1e2d", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "fitness_weekly_checkin_analysis", "response_language": "en"}
}
وضع المنتج¶
مثالي لعمليات التحقق من التدريب، وتتبع العادات، ومراقبة الأداء المؤسسي.
ملاحظة
تسمح calorie_adherence_percent بقيم أعلى من 100 لتمثيل الالتزام الزائد/الامتثال الزائد.
نقاط النهاية الموصى بها¶
GET /api/v1/fitness/volume-load-analysis- واجهة برمجة تطبيقات تحليل الحمل والحجمGET /api/v1/fitness/weekly-plan- واجهة برمجة تطبيقات الخطة الأسبوعيةGET /api/v1/bmi- واجهة برمجة تطبيقات BMIGET /api/v1/tdee- واجهة برمجة تطبيقات TDEEGET /api/v1/bmr- واجهة برمجة تطبيقات BMRGET /api/v1/protein-calculator- واجهة برمجة تطبيقات حاسبة البروتين