數據分析 API
數據分析端點 — 選手檔案、體能統計、跑步分析、圖表。
GET /analytics/athlete_profile
取得選手的完整分析檔案。
Headers
- `Authorization`: `Bearer <token>`
Response (200)
| 欄位 | 類型 | 說明 |
|---|---|---|
| `total_distance` | number | 累計跑量 |
| `total_activities` | number | 累計活動數 |
| `avg_pace` | number | 平均配速 |
| `pb_5k` | string | 5K 最佳成績 |
| `pb_10k` | string | 10K 最佳成績 |
| `pb_half` | string | 半馬最佳成績 |
| `pb_full` | string | 全馬最佳成績 |
GET /analytics/fitness_stats
取得體能統計數據。
Query Parameters
| 參數 | 類型 | 說明 |
|---|---|---|
| `user_id` | string | 使用者 ID |
| `period` | string | 時間區間（`week`, `month`, `year`） |
Response (200)
| 欄位 | 類型 | 說明 |
|---|---|---|
| `ctl` | number | 慢性訓練負荷（Chronic Training Load） |
| `atl` | number | 急性訓練負荷（Acute Training Load） |
| `tsb` | number | 訓練壓力平衡（Training Stress Balance） |
| `weekly_distance` | number | 週跑量 |
| `weekly_duration` | number | 週訓練時間 |
GET /analytics/running_stats
取得跑步統計。
Response (200)
| 欄位 | 類型 | 說明 |
|---|---|---|
| `total_runs` | number | 總跑步次數 |
| `total_distance_km` | number | 總跑量（km） |
| `avg_distance_per_run` | number | 每次平均距離 |
| `avg_pace` | string | 平均配速 |
| `longest_run` | number | 最長單次距離 |
GET /analytics/user_metrics_charts
取得使用者的圖表數據。
Query Parameters
| 參數 | 類型 | 說明 |
|---|---|---|
| `user_id` | string | 使用者 ID |
| `metric` | string | 指標類型（`distance`, `pace`, `hr`） |
| `period` | string | 時間區間 |
GET /analytics/running_heatmap
取得跑步活動頻率熱力圖。
GET /analytics/coach_athletes_metrics
取得教練旗下所有選手的指標（教練專用）。
Query Parameters
| 參數 | 類型 | 說明 |
|---|---|---|
| `org_id` | string | 組織 ID |
| `metric` | string | 指標類型 |