長寿スコア API¶
日々のバイオメトリクスとライフスタイルの信号を、構造化された改善の優先順位に基づいて、実用的な長寿スコアに変換します。
エンドポイント¶
GET /api/v1/fitness/longevity-scorePOST /api/v1/fitness/longevity-score/post
パラメータ¶
| 名前 | 型 | 必須 | イン | 説明 |
|---|---|---|---|---|
resting_hr | 数値 (30-120) | はい | クエリ/ボディ | 静止心拍数 (bpm)。 |
vo2max | 数値 (10-90) | はい | クエリ/ボディ | VO2 max の推定値/値。 |
body_fat_percentage | 数値 (3-60) | はい | クエリ/ボディ | 体脂肪率。 |
sleep_hours | 数値 (0-16) | はい | クエリ/ボディ | 平均睡眠時間。 |
weekly_activity_minutes | 整数 (0-2000) | はい | クエリ/ボディ | 1週間のアクティブな分の合計。 |
lang | 文字列 | いいえ | クエリ | レスポンス言語 (en, es, de, fr, pt, ja, hi, ar)。 |
このエンドポイントを使用する理由¶
- 長寿と心血管・代謝リスクを1つのモデル出力に統合します。
- 運用目標とコンプライアンスの優先順位を返します。
- 大規模なコーチングまたは予防ケアの自動化を可能にします。
リクエストの例¶
curl -X GET "https://api.hefitapi.com/api/v1/fitness/longevity-score?resting_hr=62&vo2max=42&body_fat_percentage=21&sleep_hours=7.4&weekly_activity_minutes=210&lang=en" \
-H "X-API-Key: YOUR_API_KEY"
curl -X POST "https://api.hefitapi.com/api/v1/fitness/longevity-score/post?lang=en" \
-H "Content-Type: application/json" \
-H "X-API-Key: YOUR_API_KEY" \
-d '{"resting_hr":68,"vo2max":35,"body_fat_percentage":28,"sleep_hours":6.5,"weekly_activity_minutes":160}'
レスポンスの例¶
Info
下記はデモンストレーション用の例です。 このエンドポイントにリクエストして、完全でリアルタイム、およびより詳細な JSON 構造を受け取ってください。
{
"longevity_score": 71,
"cardiometabolic_risk": {
"level": "low",
"level_label": "Low",
"insight": "Current profile supports favorable long-term cardiometabolic outlook."
},
"lifestyle_improvement_priorities": [
"Progress aerobic capacity with consistent zone-2 work",
"Stabilize sleep timing for recovery quality"
],
"longevity_action_plan": ["Maintain weekly movement baseline and progression"],
"quarterly_targets": ["Improve VO2max trend", "Hold resting HR within target band"],
"compliance_priorities": ["Adhere to weekly training minimum"],
"medical_escalation_flags": [],
"component_scores": {
"resting_hr_score": 62,
"vo2max_score": 63,
"body_fat_score": 97,
"sleep_score": 90,
"activity_score": 85
},
"inputs": {
"resting_hr_bpm": 62.0,
"vo2max": 42.0,
"body_fat_percentage": 21.0,
"sleep_hours": 7.4,
"weekly_activity_minutes": 210
},
"summary": "Low-risk longevity profile with targeted optimization opportunities.",
"language": "en",
"_enterprise": {
"client": "Acme Health",
"plan": "pro",
"request_id": "fe6c1f1be07d4dd2",
"quota": 120,
"usage_tracking": true
},
"_api_metadata_": {
"endpoint_name": "fitness_longevity_score",
"response_language": "en"
}
}
製品のポジショニング¶
エンタープライズのウェルネスプログラム、保険会社のエンゲージメントプラットフォーム、およびプレミアムなパフォーマンス・ヘルス製品向けに設計されています。
注意
weekly_activity_minutes は 0-2000 である必要があります。範囲外の値は HTTP 400 を返します。
推奨されるエンドポイント¶
GET /api/v1/fitness/recovery-score- 復帰スコア APIGET /api/v1/fitness/sedentary-risk-score- 運動不足リスクスコア APIGET /api/v1/bmi- BMI APIGET /api/v1/tdee- TDEE APIGET /api/v1/bmr- BMR APIGET /api/v1/protein-calculator- タンパク質計算 API