Skip to main content
NexRex Developer API 讓教練機構能夠以程式化方式存取他們在 NexRex 中管理的 訓練資料——運動員(Athletes)、活動(Activities)、訓練計畫(Training Plans)、群組(Groups)—— 並可隨時執行資料匯出。這是我們資料可攜承諾背後的 API: 你的訓練資料屬於你,可自由讀取、搬移與建構。
這是一個唯讀與匯出的 API,不會修改運動員資料。寫入操作 (提議課表調整或計畫修訂)透過 NexRex 的教練審核工作流程處理,不透過此 API。

適用對象

開發者在教練機構資料上建構工具——分析儀表板、學員名單報告、平台間的資料遷移, 或彙整團隊狀態的 AI 助理。存取範圍限定於機構(org-scoped):由機構核發的金鑰 只能存取該機構的資料。

Base URL

本文件中的所有路徑皆相對於此 base URL。例如, GET /org 即為 https://api.nexrex.ai/api/v1/developer/v1/org

版本控制

API 以日期作為版本號。目前版本為 2026-07-01,每個回應的 X-API-Version 標頭皆會回傳此版本。 重大變更至少提前 90 天公告——詳見棄用政策

機器可讀規格

完整的 API 合約以 OpenAPI 3.1 文件形式發布並即時提供:
將此 URL 指向你的程式碼產生器、Postman 或 IDE,即可直接生成型別與請求。

開始使用

1

啟用 Developer API

Developer API 存取權為 Club 方案的一部分。若你的機構已訂閱 Club 方案,此功能即已啟用。
2

建立 API 金鑰

由主教練或機構管理員在 Coach Console 的 Settings → Security 下建立金鑰。 詳見認證
3

選擇存取範圍與到期日

僅授予你的整合所需的存取範圍(Scopes),並設定到期日(預設為 90 天)。
4

發出第一個請求

認證

建立金鑰、設定到期日,並在請求中傳送金鑰。

存取範圍

七種權限及舊版金鑰的對應方式。

匯出

執行非同步資料匯出並下載結果。

錯誤

錯誤信封格式與所有機器可讀的錯誤代碼。