查看原文

数据格式与单位

摘要版本

只读接口返回 schema_version: 1。此版本描述网页摘要,不改变原始运动归档格式,也不重算历史指标。发现未知版本时停止解析并更新客户端。

字段契约

字段类型含义
idstring活动 UUID
titlestring原记录名称
daystringYYYY-MM-DD,保存的运动日期
started_msintegerUTC Unix 毫秒
sportstring运动类型标识
distance_metersinteger 或 null保存的距离,单位米
total_secondsinteger保存的总时长,单位秒
sourcestring原活动来源

距离缺失保持 null,不使用零代替。真实零保留为 0。室内运动可能没有跑步距离。客户端展示单位转换不会改变导出原值。

分页与一致性

列表按 started_ms 倒序,同一时间按 id 倒序。limit 为 1–100,默认 25;next_offset 为 null 表示结束。分页是当前数据视图,不是跨请求冻结快照;同步或删除可能改变后续页,长时间遍历应按 ID 去重。

原始数据

本接口不提供定位点、传感器事件或照片。不能用摘要还原完整运动轨迹或传感器记录。

更新于