モビリティ評価 API¶
モビリティ評価の入力を、深刻度スコア、制限領域マップ、および修正ガイダンスに変換します。
エンドポイント¶
GET /api/v1/fitness/mobility-assessmentPOST /api/v1/fitness/mobility-assessment/post
パラメータ¶
| 名前 | タイプ | 必須 | クエリ/ボディ | 説明 |
|---|---|---|---|---|
ankle_mobility_score | 数値 (0-100) | はい | クエリ/ボディ | ふくらはぎの可動性スコア。 |
hip_mobility_score | 数値 (0-100) | はい | クエリ/ボディ | 股関節の可動性スコア。 |
shoulder_mobility_score | 数値 (0-100) | はい | クエリ/ボディ | 肩の可動性スコア。 |
posture_type | 文字列 | はい | クエリ/ボディ | neutral,anterior_pelvic_tilt,kyphotic,lordotic,swayback,flat_back。 |
lang | 文字列 | いいえ | クエリ | レスポンス言語 (en,es,de,fr,pt,ja,hi,ar)。 |
このエンドポイントを使用する理由¶
- モビリティ評価を構造化された修正プログラムに変換します。
- 最も制限的な運動領域を迅速に特定します。
- コーチング製品向けのウォーミングアップのパーソナライズロジックを生成します。
リクエストの例¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/mobility-assessment?ankle_mobility_score=52&hip_mobility_score=61&shoulder_mobility_score=68&posture_type=anterior_pelvic_tilt&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/mobility-assessment/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"ankle_mobility_score":58,"hip_mobility_score":55,"shoulder_mobility_score":63,"posture_type":"kyphotic"}'
レスポンスの例¶
Info
以下のレスポンス例は、あくまでデモンストレーション用です。 このエンドポイントに実際のリクエストを行い、完全な、リアルタイム、および可能性のあるより詳細なJSON構造を取得してください。
{
"ankle_mobility_score": 52.0,
"hip_mobility_score": 61.0,
"shoulder_mobility_score": 68.0,
"posture_type": "anterior_pelvic_tilt",
"posture_type_label": "Anterior Pelvic Tilt",
"composite_mobility_score": 60,
"restriction_severity": {
"score": 47,
"level": "moderate",
"level_label": "Moderate",
"insight": "Mobility deficits may limit movement quality under load."
},
"limiting_regions": [
{"region": "ankle", "region_label": "Ankle", "score": 52.0, "restriction_level": "moderate"},
{"region": "hip", "region_label": "Hip", "score": 61.0, "restriction_level": "moderate"},
{"region": "shoulder", "region_label": "Shoulder", "score": 68.0, "restriction_level": "low"}
],
"corrective_focus": ["Restore ankle and hip mobility through daily drills"],
"warmup_customization_advice": ["Add mobility prep before loaded sessions"],
"retest_window_days": 21,
"confidence_score": 76,
"summary": "Moderate restriction profile with targeted corrective opportunity.",
"language": "en",
"_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "71d65d488d78d9b4", "quota": 120, "usage_tracking": true},
"_api_metadata_": {"endpoint_name": "fitness_mobility_assessment", "response_language": "en"}
}
製品の位置づけ¶
運動スクリーニングアプリおよびコーチングSaaSワークフロー向けの、実用的なコアエンドポイント。
注意
すべての可動性スコアは、0-100である必要があります。無効な値はHTTP 400を返します。
推奨されるエンドポイント¶
GET /api/v1/bmi- BMI APIGET /api/v1/tdee- TDEE APIGET /api/v1/bmr- BMR APIGET /api/v1/protein-calculator- タンパク質計算 APIGET /api/v1/fitness/heart-rate-zones- ハートレートゾーン APIGET /api/v1/bodyfat- 体脂肪 API