# 沐禾健康 · 服务端知识库 > 运动健康数据链的开发者地图 33 个业务模块 · 146 条 API · 217 个错误码 · 2745 项测试 — 全部实测（2026-09-20） ## Table of Contents ### 🟢 uniapp前端开发指引 - [uniapp 前端开发指引](/guide/uniapp.md) - [page-api-reference —— 前端页面 × 后端 API 反向索引（v1）](/guide/uniapp/page-api-reference.md) - [规范项目结构树（uniapp CLI 编译要求对照）](/guide/uniapp/structure.md) - [三层差异对比（CNB 前端仓库 → V1 → V2）](/guide/uniapp/comparison.md) - [贡献记录（多用户提交统计）](/guide/uniapp/CONTRIBUTION.md) ### API 调用契约 - [uniapp API 调用契约 · 总览与分工边界](/guide/uniapp/api.md) - [Agreement 用户协议（前端调用视角）](/guide/uniapp/api/agreement.md) - [City Ranking 城市里程榜（前端调用视角）](/guide/uniapp/api/city-ranking.md) - [Run Share 跑步分享图 + finishRun 接线（前端调用视角）](/guide/uniapp/api/run-share.md) - [运动记录 API 三件套（列表 / 详情 / 轨迹图）— 接口说明 + 调用 + 真实样例](/guide/uniapp/api/sport-records.md) - [运动上报联调排障记录 —— submitRun 400（2026-10-10）](/guide/uniapp/api/run-submit-debug.md) - [Sport Record Share Image 运动记录轨迹图（前端调用视角）](/guide/uniapp/api/sport-record-share.md) - [Device 设备线（前端调用视角）](/guide/uniapp/api/device.md) - [OAuth 登录链（前端调用视角 · 7 端点）](/guide/uniapp/api/oauth.md) - [Stats 今日概览（前端调用视角）](/guide/uniapp/api/stats.md) - [Training 训练计划（前端调用视角）](/guide/uniapp/api/training.md) - [User 向导链（前端调用视角 · 7 端点）](/guide/uniapp/api/user.md) ### 页面说明（34） - [index](/guide/uniapp/pages/agreement.md) - [index](/guide/uniapp/pages/ai.md) - [page-calories-detail](/guide/uniapp/pages/detail-page-calories-detail.md) - [page-health-summary](/guide/uniapp/pages/detail-page-health-summary.md) - [page-heart-rate-detail](/guide/uniapp/pages/detail-page-heart-rate-detail.md) - [page-oxygen-detail](/guide/uniapp/pages/detail-page-oxygen-detail.md) - [page-run-step-detail](/guide/uniapp/pages/detail-page-run-step-detail.md) - [page-sleep-detail](/guide/uniapp/pages/detail-page-sleep-detail.md) - [page-sport-detail](/guide/uniapp/pages/detail-page-sport-detail.md) - [page-spots-list](/guide/uniapp/pages/detail-page-spots-list.md) - [page-strength-detail](/guide/uniapp/pages/detail-page-strength-detail.md) - [page-stress-detail](/guide/uniapp/pages/detail-page-stress-detail.md) - [page-weight-detail](/guide/uniapp/pages/detail-page-weight-detail.md) - [select-date](/guide/uniapp/pages/detail-select-date.md) - [select-symmary-date](/guide/uniapp/pages/detail-select-symmary-date.md) - [add\_weight-page](/guide/uniapp/pages/form-add_weight-page.md) - [pages/index — 首页（今日健康）](/guide/uniapp/pages.md) - [pages/login — 手机号登录](/guide/uniapp/pages/login.md) - [device-sessions](/guide/uniapp/pages/mine-account-security-device-sessions.md) - [index](/guide/uniapp/pages/mine-account-security.md) - [device-list](/guide/uniapp/pages/mine-data-device-list.md) - [heart-rate-list](/guide/uniapp/pages/mine-data-heart-rate-list.md) - [linked\_app](/guide/uniapp/pages/mine-data-linked_app.md) - [index](/guide/uniapp/pages/mine.md) - [health-records](/guide/uniapp/pages/mine-info-health-records.md) - [personal-form](/guide/uniapp/pages/mine-info-personal-form.md) - [sports-data](/guide/uniapp/pages/mine-sports-sports-data.md) - [index](/guide/uniapp/pages/mine-version.md) - [pages/my-plan — 我的计划（训练打卡）](/guide/uniapp/pages/my-plan.md) - [index](/guide/uniapp/pages/run.md) - [setting](/guide/uniapp/pages/run-setting.md) - [sport-index](/guide/uniapp/pages/run-sport-index.md) - [start-run-time](/guide/uniapp/pages/run-start-run-time.md) - [index](/guide/uniapp/pages/webview.md) ### 组件说明（20） - [qm-activity-banner](/guide/uniapp/components/qm-activity-banner.md) - [qm-activity-rings](/guide/uniapp/components/qm-activity-rings.md) - [qm-age-picker](/guide/uniapp/components/qm-age-picker.md) - [qm-bottom-bar](/guide/uniapp/components/qm-bottom-bar.md) - [qm-circle-progress](/guide/uniapp/components/qm-circle-progress.md) - [qm-daily-activity-card](/guide/uniapp/components/qm-daily-activity-card.md) - [qm-detail-period-tabs](/guide/uniapp/components/qm-detail-period-tabs.md) - [qm-height-picker](/guide/uniapp/components/qm-height-picker.md) - [qm-mini-activity-rings](/guide/uniapp/components/qm-mini-activity-rings.md) - [qm-period-tabs](/guide/uniapp/components/qm-period-tabs.md) - [qm-profile-setup-popup](/guide/uniapp/components/qm-profile-setup-popup.md) - [qm-run-dashboard](/guide/uniapp/components/qm-run-dashboard.md) - [qm-run-gps-status](/guide/uniapp/components/qm-run-gps-status.md) - [qm-run-location-button](/guide/uniapp/components/qm-run-location-button.md) - [qm-run-theme-switch](/guide/uniapp/components/qm-run-theme-switch.md) - [qm-sleep-wave](/guide/uniapp/components/qm-sleep-wave.md) - [qm-sport-chart-card](/guide/uniapp/components/qm-sport-chart-card.md) - [qm-swipe-up](/guide/uniapp/components/qm-swipe-up.md) - [qm-title-bar](/guide/uniapp/components/qm-title-bar.md) - [qm-weight-picker](/guide/uniapp/components/qm-weight-picker.md) ### 工具说明（9） - [common-util](/guide/uniapp/utils/common-util.md) - [device](/guide/uniapp/utils/device.md) - [request-pernission](/guide/uniapp/utils/request-pernission.md) - [request](/guide/uniapp/utils/request.md) - [run-coordinate-reporter](/guide/uniapp/utils/run-coordinate-reporter.md) - [storage](/guide/uniapp/utils/storage.md) - [system-tts](/guide/uniapp/utils/system-tts.md) - [toastUtil](/guide/uniapp/utils/toastUtil.md) - [validUtil](/guide/uniapp/utils/validUtil.md) ### ⭐ 前端联调 API 手册（30 端点） - [前端联调 API 手册（v1）](/api-docs/v1/frontend.md) ### 按前端源码文件分组 - [前端联调 · 登录认证（login.ts）](/api-docs/v1/frontend/login.md) - [前端联调 · 用户资料（user.ts）](/api-docs/v1/frontend/user.md) - [前端联调 · 设备线（device.ts）](/api-docs/v1/frontend/device.md) - [前端联调 · 训练中心（training.ts）](/api-docs/v1/frontend/training.md) - [前端联调 · 开机信息屏（splash.ts）](/api-docs/v1/frontend/splash.md) - [前端联调 · 用户协议（agreement.ts）](/api-docs/v1/frontend/agreement.md) - [前端联调 · 页面直调（3 个端点）](/api-docs/v1/frontend/page-direct.md) - [首页 API 接口参考](/api-docs/v1/frontend/home-api-reference.md) ### 🔢 字段「值」速查（语义层） - [前端联调 · 取值速查（字段值语义）](/api-docs/v1/frontend/values.md) ### ⚠️ 接线必读（19 个新接口） - [前端接线必读 —— 19 个新 API 的对接陷阱与兜底](/api-docs/v1/frontend/wiring-guide.md) - [Dev / Prd 双库对照 —— 一致性、仿真数据边界、问题处理](/api-docs/v1/frontend/dual-env.md) ### OAuth 登录认证 - [OAuth 登录认证（v1）](/api-docs/v1/oauth.md) - [9 Action 完整字段表](/api-docs/v1/oauth/actions.md) - [OAuth 错误码矩阵（40101xxx）](/api-docs/v1/oauth/error-codes.md) - [OAuth 错误码矩阵（HTTP 视角 · 40101001 ~ 40101012）](/api-docs/v1/oauth/errors.md) - [验证码状态机（captcha + sms-code）](/api-docs/v1/oauth/state-machine.md) - [OAuth 安全规范（前端对接义务）](/api-docs/v1/oauth/security.md) - [OAuth 限流规则（客户端如何优雅共处）](/api-docs/v1/oauth/rate-limits.md) - [OAuth SDK 参考（uniapp · 拷入即用）](/api-docs/v1/oauth/sdk.md) - [uniapp 前端开发指南（OAuth 登录链落地手册）](/api-docs/v1/oauth/uniapp-dev-guide.md) - [OAuth 前后联调实录 —— 实测差异与调试循环](/api-docs/v1/oauth/integration-notes.md) ### Admin MIS（82 use case / 12 子域） - [Admin MIS 管理后台（v1）](/api-docs/v1/admin.md) - [auth — adminLogin（3 action）](/api-docs/v1/admin/auth.md) - [dashboard — 仪表盘（5 action）](/api-docs/v1/admin/dashboard.md) - [user（C 端用户管理）— 10 action](/api-docs/v1/admin/users.md) - [content — 内容管理（8 action）](/api-docs/v1/admin/content.md) - [order — 订单管理（10 action）](/api-docs/v1/admin/orders.md) - [withdrawal — 提现审批（6 action）](/api-docs/v1/admin/withdrawals.md) - [review — 评价审核（5 action）](/api-docs/v1/admin/reviews.md) - [interpret — 解读报告（5 action）](/api-docs/v1/admin/interpret.md) - [release — App 版本发布（5 action）](/api-docs/v1/admin/release.md) - [channel — 支付/分发渠道（5 action）](/api-docs/v1/admin/channels.md) - [config — 系统/业务/灰度/告警配置（12 action）](/api-docs/v1/admin/config.md) - [misc — 杂项（审计/日志/字典/通知）（5 action · 全只读）](/api-docs/v1/admin/misc.md) ### User（C 端 / 11 action） - [user —— C 端用户模块（15 action）](/api-docs/v1/user/actions.md) ### City（选择城市 / 4 action） - [city —— 选择城市（C 端 / 4 action）](/api-docs/v1/city.md) - [city —— 错误码矩阵（40431xxx）](/api-docs/v1/city/error-codes.md) ### Ranking（多维榜单 / 2 action） - [ranking —— 多维榜单（C 端 / 3 action）](/api-docs/v1/ranking.md) - [ranking —— 错误码矩阵（40422xxx）](/api-docs/v1/ranking/error-codes.md) ### 业务域 v1（shoes/sport/资产/社交） - [shoes API（跑鞋库）](/api-docs/v1/shoes.md) - [training API（训练中心）](/api-docs/v1/training.md) - [goal API（目标系统）](/api-docs/v1/goal.md) - [sport API（运动打卡 + 跑群 + 跑步会话）](/api-docs/v1/sport.md) - [upload API（数据包上传）](/api-docs/v1/upload.md) - [wallet API（钱包）](/api-docs/v1/wallet.md) - [points API（积分）](/api-docs/v1/points.md) - [coupon API（优惠券）](/api-docs/v1/coupon.md) - [cart API（购物车）](/api-docs/v1/cart.md) - [mall API（商城）](/api-docs/v1/mall.md) - [group\_buy API（拼团）](/api-docs/v1/group_buy.md) - [distribution API（分销）](/api-docs/v1/distribution.md) - [feed API（社区动态）](/api-docs/v1/feed.md) - [follow API（关注）](/api-docs/v1/follow.md) - [favorite API（收藏）](/api-docs/v1/favorite.md) - [review API（C 端评价）](/api-docs/v1/review.md) - [Suunto API（设备线）](/api-docs/v1/suunto.md) ### Device（设备线） - [device —— 设备共享域（v1）](/api-docs/v1/device.md) - [vendors —— 授权中心（四态状态机）](/api-docs/v1/device/vendors.md) - [honor —— 荣耀健康（v1）](/api-docs/v1/device/honor.md) - [zepp —— Zepp 健康（v1）](/api-docs/v1/device/zepp.md) ### AI 上下文 - [代码风格](/ai-contexts/code-style.md) - [模块约定](/ai-contexts/module-conventions.md) ### Guide - [快速上手（Quick Start）](/guide/quickstart.md) - [QM-ServerV2 知识库总索引](/guide/kb-map.md) ### 模块手册（26 模块） - [模块手册](/modules.md) - [模块手册 · 管理域（admin）](/modules/admin.md) ### Other - [agreement — 协议发布（1 端点）](/api-docs/v1/admin/agreement.md) - [AI Contexts](/ai-contexts.md) - [API Docs](/api-docs.md) - [COS STS 临时密钥直传 — 前端接入指南](/guide/integration/cos-sts-direct-upload.md) - [Health Archive 健康档案（前端调用视角）](/guide/uniapp/api/health-archive.md) - [Sport 运动会话 + 记录（前端调用视角）](/guide/uniapp/api/sport.md) - [storage — 存储管理（STS 直传链路）（7 action）](/api-docs/v1/admin/storage.md) - [xiaomi —— 小米运动健康（v1）](/api-docs/v1/device/xiaomi.md) - [前端 APP COS 直传 — 使用指南](/api-docs/v1/frontend/app-storage.md) - [开机信息屏（前端调用视角 · 2 端点）](/guide/uniapp/api/splash.md) - [按功能浏览 —— 11 大功能类（业务能力聚合）](/api-docs/v1/capabilities.md) - [模块手册 · 交易与资产域（trade-assets）](/modules/trade-assets.md) - [模块手册 · 社区域（community）](/modules/community.md) - [模块手册 · 认证与用户域（auth-user）](/modules/auth-user.md) - [模块手册 · 设备线（device-line）](/modules/device-line.md) - [模块手册 · 运动健康域（sport-health）](/modules/sport-health.md) - [资料直传 API（COS STS 直传通道）— APP 使用手册与测试样例](/api-docs/v1/upload/direct-upload.md) - [错误码权威注册表（Error Code Registry）](/ai-contexts/error-code-registry.md) - [页面直调端点（不在 `src/api/*.ts` 里的 3 条）](/guide/uniapp/api/page-direct.md)