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

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

قياس القوة الإجمالية وقوة محددة لكل تمرين مقارنة بالوزن، مع إرشادات تركز على التقدم.

نقطة النهاية

  • GET /api/v1/fitness/strength-benchmark
  • POST /api/v1/fitness/strength-benchmark/post

المعلمات

الاسم النوع مطلوب في الوصف
gender سلسلة نعم الاستعلام/الجسم male أو female.
weight رقم (35-300) نعم الاستعلام/الجسم وزن الجسم بالكيلوغرام.
squat_1rm رقم (20-450) نعم الاستعلام/الجسم 1RM في تمرين الضغط بالكيلوغرام.
bench_1rm رقم (15-350) نعم الاستعلام/الجسم 1RM في تمرين الضغط بالكيلوغرام.
deadlift_1rm رقم (30-500) نعم الاستعلام/الجسم 1RM في تمرين الرفعة المميتة بالكيلوغرام.
lang سلسلة لا الاستعلام لغة الاستجابة (en,es,de,fr,pt,ja,hi,ar).

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

  • توحيد تصنيف القوة لمنتجات التدريب.
  • تحديد التمارين الأضعف لتحديد مسار التقدم المستهدف.
  • إضافة الثقة والتوجيه لتطوير تقارير القوة.

ابدأ الآن

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

curl -X GET "https://api.hefitapi.com/api/v1/fitness/strength-benchmark?gender=male&weight=82&squat_1rm=150&bench_1rm=105&deadlift_1rm=195&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/strength-benchmark/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"gender":"female","weight":64,"squat_1rm":102,"bench_1rm":58,"deadlift_1rm":128}'

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

معلومات

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

{
  "gender": "male",
  "bodyweight_kg": 82.0,
  "one_rep_max_kg": {"squat_1rm": 150.0, "bench_1rm": 105.0, "deadlift_1rm": 195.0, "total_1rm": 450.0},
  "relative_strength_ratios": {"squat_to_bw": 1.83, "bench_to_bw": 1.28, "deadlift_to_bw": 2.38, "total_to_bw": 5.49},
  "classification_level": "advanced",
  "classification_label": "Advanced",
  "lift_classification": {
    "squat": {"level": "advanced", "label": "Advanced"},
    "bench": {"level": "advanced", "label": "Advanced"},
    "deadlift": {"level": "elite", "label": "Elite"}
  },
  "weakest_link_focus": {"lift": "bench", "label": "Bench", "guidance": "Prioritize bench-focused volume and technique quality."},
  "strength_balance_index": 88,
  "confidence": {"level": "high", "label": "High"},
  "development_guidance": ["Use progressive overload with weak-link emphasis"],
  "summary": "Advanced total profile with clear bench-focused upside.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "f8910571e304d536", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_strength_benchmark", "response_language": "en"}
}

وضع المنتج

مثالي لتطبيقات القوة، ولوحات معلومات الرياضيين، ومنصات التدريب الأداء المؤسسية.

ملاحظة

إرجاع قيم 1RM خارج النطاقات المحددة يُرجع خطأ HTTP 400.

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