> ## Documentation Index
> Fetch the complete documentation index at: https://docs.nexrex.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# 棄用政策

> 我們如何對 API 進行版本控制，以及如何溝通重大變更。

Developer API 是 NexRex [資料可攜承諾](https://nexrex.ai/data-portability)的一部分：
如果你基於此 API 進行開發，我們不會讓你措手不及。

## 我們的承諾

* **重大變更至少提前 90 天公告**，除非安全或法律緊急情況需要立即變更。
* 我們在每個回應的 `X-API-Version` 標頭發布版本日期（目前為 `2026-07-01`）。
  重大變更以新版本日期發布；前一版本在公告期內持續有效。
* **新增變更不屬於重大變更。** 回應中可能隨時新增欄位，也可能隨時新增端點。
  請建構你的用戶端以忽略未知欄位。

## 什麼算作重大變更

* 移除或重新命名端點、欄位、存取範圍或錯誤代碼
* 變更現有欄位的型別或含義
* 收緊驗證規則，導致先前有效的請求被拒絕
* 降低請求頻率限制

## 掌握最新資訊

重大變更通知發布於[資料可攜承諾](https://nexrex.ai/data-portability)頁面及其變更記錄。
機器可讀的 [OpenAPI 規格](https://api.nexrex.ai/api/v1/developer/v1/openapi.json)
始終反映目前版本——透過比對差異即可確切了解變更內容。

## 目前限制

這是 v1。部分功能目前尚未提供：

* **僅供讀取與匯出**——尚無寫入或提議端點，也無 webhooks。
* **GPX / FIT / TCX** 匯出格式尚未提供（目前僅限 CSV 與 JSON）。
* 部分原始廠商資料可能受上游提供商條款限制，不包含在匯出中。