CurrentStation Passport

让你的应用
用通行证登录

用户一次登录，全 Current 系产品通用。你的应用只拿到被授权的信息，永远拿不到密码。

  • 1
    标准 OAuth 2.0 + PKCE授权码换令牌；公开客户端无需密钥；刷新令牌 30 天且每次轮换。
  • 2
    自助登记，即时可用建应用、填主页与回调地址、拿 client_id 与密钥，全在浏览器里完成。
  • 3
    用户可控、全程留痕用户随时可在设置里解除授权；登记/授权/换令牌/撤销都有审计。
接入长这样
# 1) 送用户去授权页（PKCE）
/cm/passport/authorize?response_type=code
  &client_id=cs_app_…&redirect_uri=https://你的域名/cb
  &scope=openid%20profile&code_challenge=…

# 2) 回调用 code 换令牌
POST /cm/passport/token → cs_at_… + cs_rt_…

# 3) 取资料
GET /cm/passport/userinfo → { sub, nickname, email }
登录后即可登记应用。通行证账号与 CurrentMusic 客户端通用。

我的应用

已登记 0 / 5 在用授权 0 管理员

四步接入

拿到 client_id 后，按下面四步就能跑通「通行证登录」。

  1. 把用户送到授权页

    GET /cm/passport/authorize?client_id=…&redirect_uri=…&scope=…&state=…&code_challenge=…&code_challenge_method=S256

  2. 回调里拿 code

    用户在通行证页面点「同意」后跳回你登记的回调地址，带上 ?code=…&state=…（code 60 秒、只能用一次）。

  3. 用 code 换令牌

    服务端 POST /cm/passport/token，带 code_verifier（公开客户端）或 client_secret（机密客户端）。

  4. 拿用户信息

    GET /cm/passport/userinfo 带 Authorization: Bearer cs_at_…，按 scope 返回昵称/头像/脱敏邮箱等。

完整文档 平台元信息