2026-08-15首選語言權限更新 開發人員
上次更新：2026年8月15日
2026-08-15首選語言權限更新
更新日期：2026 年 8 月 15 日
通行帳戶已支援使用者設定首選語言；開發者識別碼可申請細項權限 locale，在授權回呼中讀取該偏好。
相容提示
- 已上線的舊用戶端無需因本次更新而改程式碼或重新發布。 未申請
locale時，行為與更新前相同。- 若你需要依使用者語言顯示介面或寄信，請在開發者入口網站為識別碼勾選
locale（可選或必選）。
摘要
- 使用者可在通行帳戶「個人資訊」中設定首選語言：
zh-CN、zh-TW、en、ja。 - 新增資料細項
scope：locale，對應 UserInfo / ID Token 聲明locale（BCP 47）。 - 已授予
locale時，ID Token 與 UserInfo 均包含該聲明，授權重新導向回呼即可讀取，不必先再呼叫一次 UserInfo。 - 未授予時，UserInfo 仍回傳空字串佔位，不會洩漏真實偏好。
- 新建識別碼預設把
locale列為可選；既有識別碼須在入口網站「功能」步驟自行勾選。
詳細欄位表見同目錄上級的《權限與同意》《權杖與使用者資訊》；帳戶側說明見通行帳戶指南《個人資訊》。
你需要做什麼
| 情境 | 建議 |
|---|---|
| 不需要使用者語言 | 無需改動。舊用戶端維持原樣。 |
| 需要依語言在地化 | 編輯識別碼，將 locale 設為可選或必選（必選須填理由與隱私權政策）。從 ID Token 或 UserInfo 讀取 locale，再依權杖 scope 判斷是否已授權。 |
| 不要把佔位值當成真實偏好 | 未出現在 scope 中的 locale 為空字串，表示未授權，不是「使用者未設定」。 |
簡訊驗證碼仍為簡體中文，不隨首選語言變化。
文件路徑
文件中心四種語言共用英語 URL，例如：
https://docs.swaymoon.com/zh-TW/view/swaymoon-developer/guides/identifiers/scopes-and-consent?developer=true
https://docs.swaymoon.com/en/view/swaymoon-developer/guides/identifiers/scopes-and-consent?developer=true
舊中文路徑會重新導向到上述英語路徑。