T-fit Training Tracker

加入 T-fit

Join T-fit

註冊一個專屬的 Strava App，授權後就可以開始追蹤你的訓練負荷。
Register your own Strava App and authorize it; T-fit will then track your training load.

為什麼每個人都要自己註冊 Strava App？

Strava 規定每個 App 預設只能連結 1 位運動同好。在 T-fit 通過 Strava 提額審核前（已申請、等待中），最快讓每位朋友都能加入的方法就是每人用自己的 Strava 帳號註冊一個專屬 App（只連自己）。整個設定約 3 分鐘。

Why does each member register their own Strava App? Strava limits each app to 1 connected athlete by default. Until our app-rate-limit increase is approved, the fastest workaround is for each member to register their own Strava App (linked only to themselves). Setup takes about 3 minutes.

1登入 Strava，開啟 API 設定頁

Log into Strava and open the API settings page

前往下方連結。若還沒登入會先跳到登入頁，登入後會直接看到「建立應用程式」表單（沒有額外按鈕要點）。
Open the link below. If you're not logged in yet you'll see the login page first; once logged in you'll land directly on the "Create Application" form (no extra button to click).

https://www.strava.com/settings/api ↗

登入後直接看到的「建立應用程式」表單
The 'Create Application' form you land on after login

2依下表填寫表單欄位

Fill in the form fields per the table below

請照下表填寫（特別注意最容易填錯的 Authorization Callback Domain）：
Fill in each field per the table below. Pay special attention to Authorization Callback Domain — this is the field people most often get wrong.

欄位 / Field	填什麼 / What to enter
Application Name 應用程式名稱	`T-fit Personal` or any name you like / 任意名字皆可
類別 / Category	`表現分析` = "Performance Analysis" (the closest category)
社團 / Club	留空 / Leave empty
網站 / Website	`https://t-fit-app.vercel.app` The T-fit URL / T-fit 網址
應用程式說明 / Application Description	任意填，例如 / Anything, e.g. `Personal training load tracker`
授權回撥網域 / Authorization Callback Domain ⚠️ 最容易填錯 / Most common mistake	`t-fit-app.vercel.app` 只填 domain，不要 `https://`、不要結尾 `/`、不要 port Domain only — no `https://` prefix, no trailing slash, no port number.

勾選「我已閱讀並同意 Strava 的 API 協議」後按「建立」。
Check the "I have read and agree to the Strava API Agreement" box, then click 建立 / Create.

表單填好後的樣子
The form after all fields are filled in

3上傳應用程式圖示

Upload the application icon

按「建立」之後 Strava 會跳到「更新應用程式圖示」頁 — 這是必要步驟，沒上傳圖示就看不到 Client ID / Secret。點「上傳」選一張圖（隨便一張正方形圖都可以，例如手機相簿裡任一張）。
After clicking Create, Strava forces you to an "Update Application Icon" screen — this is mandatory: you can't see Client ID / Secret until you upload one. Click 上傳 / Upload and pick any square image (a photo from your camera roll works).

強制要求上傳圖示的畫面
The mandatory icon upload screen

4記下 Client ID 與 Client Secret

Copy your Client ID and Client Secret

上傳圖示後就會看到 App 詳細資訊頁，找這兩個值：
After uploading the icon, you'll see your app details page. Look for these two values:

用戶端 ID / Client ID — 一串數字 / a number string, e.g. 244576
用戶端密碼 / Client Secret — 點「顯示」(Show) 可以看到一長串字母數字 / click "Show" to reveal a long alphanumeric string

下一步要把這兩個值貼到 T-fit。建議先把它們暫存到記事本，避免在多分頁切換時遺失。
You'll paste these two values into the T-fit form below. Tip: copy them to a notepad first so you don't lose them when switching tabs.

找到 Client ID 與 Client Secret 的位置
Where to find your Client ID and Client Secret

5回到本頁，往下捲，填寫下方表單

Come back to this page, scroll down, and fill in the form below

把剛剛拿到的 Client ID 與 Client Secret，連同你的顯示名稱和年齡段，填進下方表單。
Paste the Client ID and Client Secret you just copied into the form below, along with your display name and age band.

送出後，你的名字會先以「⚠️ 尚未授權」狀態出現在成員清單。
After submitting, your name appears in the member list as "⚠️ Not yet authorized" until you finish the next step.

送出後的中間狀態：尚未授權
Intermediate state after submit: not yet authorized

6在 Strava 按「Authorize」完成授權

On Strava, click 'Authorize' to finish

送出表單後會自動跳到 Strava 授權頁，按 Authorize（中文介面是「授權」）。授權成功後會跳回 T-fit，這時你才算完整加入。
After submitting, T-fit redirects you to Strava's authorization page. Click Authorize (or 授權 in Chinese). You'll be redirected back to T-fit — that's when you're fully connected.

Strava 的授權同意頁
The Strava authorization screen

沒跳轉？檢查 Authorization Callback Domain 是否填對了（Step 2 那個 ⚠️ 欄位）。
Not redirected? Double-check the Authorization Callback Domain (the ⚠️ field in Step 2).

之後想撤銷授權？

Want to revoke access later?

到 Strava 的 My Apps 頁，找到 T-fit Training Tracker 後按 Revoke Access。
Open Strava's My Apps page, find T-fit Training Tracker, and click Revoke Access.

⏰ 注意：清除不是即時的

撤銷後 T-fit 會立刻停止同步新活動。
過去存在 T-fit 的歷史活動會在下一次每日 cron 跑時（UTC 00:00 / 台北 08:00）一起刪掉。
所以最多會有 ~24 小時的延遲，期間儀表板還看得到舊資料。

⏰ Note: cleanup is not instant. Revoking immediately stops new syncs, but your historical activities in T-fit are wiped at the next daily cron run (00:00 UTC / 08:00 Taipei) — so expect up to a ~24-hour delay before the dashboard reflects the change.

Strava My Apps 頁的 Revoke Access 按鈕
The Revoke Access button on Strava's My Apps page