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-CN/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
旧中文路径会重定向到上述英语路径。