# zwift-api：梳理 Zwift 私有数据接口

> zwift-api 梳理 Zwift 的部分私有 HTTP 数据接口，并实现读取个人资料、成就、活动、任务和目录数据的只读 Node 客户端。项目记录代理抓包得到的端点，并在没有 schema 的情况下解析 protobuf 字段。作者报告史诗挑战进度经实时 UDP 路径传输，而非已整理的 HTTP 端点。

- 类型：案例
- 目标：协议
- 类别：独立重建案例
- 关联：独立重建项目
- 来源复核于：2026-11-08
- 收录于：2026-11-08
- 原始资源：<https://github.com/noerdk/zwift-api>
- 一手来源：<https://github.com/noerdk/zwift-api/blob/ebd4869b617e1eaf7d023a6366fef2d06cc3bda1/README.md>
- 目录页面：<https://awesomerea.org/zh/resources/zwift-api-case/>
- 记录 JSON：<https://awesomerea.org/resources/zwift-api-case/record.json>
- 英文版：[English](https://awesomerea.org/resources/zwift-api-case/index.md)

## 使用条件与局限

- **前提条件：**需要 Node.js 18 或更高版本；账户接口需要用户自己的 Zwift 凭据。
- **局限：**客户端仅提供读取操作；史诗挑战进度不在其 HTTP 接口覆盖范围内。
- **许可：**MIT 许可证。

## 一手来源

1. <https://github.com/noerdk/zwift-api/blob/ebd4869b617e1eaf7d023a6366fef2d06cc3bda1/README.md>
2. <https://github.com/noerdk/zwift-api/blob/ebd4869b617e1eaf7d023a6366fef2d06cc3bda1/CONTRIBUTING.md>

## 同分区更多条目：协议

- [Gear VR Controller：解析 Samsung 蓝牙遥控器协议](https://awesomerea.org/zh/resources/gear-vr-controller-ble-case/index.md) · 案例
- [Acer Predator Helios 16：重建 Linux 灯效控制](https://awesomerea.org/zh/resources/acer-predator-helios-16-rgb-case/index.md) · 案例
- [Powerology AM8268N：重建 Linux USB 显示协议](https://awesomerea.org/zh/resources/powerology-am8268n-usb-display-case/index.md) · 案例
- [SuperCam Thermal Viewer：重建 QuanLi 热成像相机串流](https://awesomerea.org/zh/resources/quanli-supercam-case/index.md) · 案例
- [ktctl：重建 FiiO JA11 的 USB 均衡器控制](https://awesomerea.org/zh/resources/ktctl-ja11-case/index.md) · 案例
- [AppleAVE2：重建 IOKit 通信格式与驱动验证路径](https://awesomerea.org/zh/resources/appleave2-wire-format-case/index.md) · 案例

## 关于此条目

说明已依据一手来源复核。
原创说明采用 MIT 许可；外部项目、论文与素材保留各自的权利和许可。