# 数据格式与单位

## 摘要版本
只读接口返回 schema_version: 1。此版本描述网页摘要，不改变原始运动归档格式，也不重算历史指标。发现未知版本时停止解析并更新客户端。
## 字段契约
| 字段 | 类型 | 含义 |
| --- | --- | --- |
| id | string | 活动 UUID |
| title | string | 原记录名称 |
| day | string | YYYY-MM-DD，保存的运动日期 |
| started_ms | integer | UTC Unix 毫秒 |
| sport | string | 运动类型标识 |
| distance_meters | integer 或 null | 保存的距离，单位米 |
| total_seconds | integer | 保存的总时长，单位秒 |
| source | string | 原活动来源 |

距离缺失保持 null，不使用零代替。真实零保留为 0。室内运动可能没有跑步距离。客户端展示单位转换不会改变导出原值。
## 分页与一致性
列表按 started_ms 倒序，同一时间按 id 倒序。limit 为 1–100，默认 25；next_offset 为 null 表示结束。分页是当前数据视图，不是跨请求冻结快照；同步或删除可能改变后续页，长时间遍历应按 ID 去重。
## 原始数据
本接口不提供定位点、传感器事件或照片。不能用摘要还原完整运动轨迹或传感器记录。