---
id: "zh/api-get-account-tokenlogin-do"
title: "JWT token 登录"
language: "zh"
description: "GET /account/tokenLogin.do：JWT token 登录 接口说明，包含路径、方法、参数和返回信息。"
canonical_url: "https://www.babel.cc/public/babelwiki/zh/api-get-account-tokenlogin-do.html"
markdown_url: "https://www.babel.cc/public/babelwiki/ai/zh/api-get-account-tokenlogin-do.md"
alternates: {"en": "https://www.babel.cc/public/babelwiki/ai/en/api-get-account-tokenlogin-do.md", "zh": "https://www.babel.cc/public/babelwiki/ai/zh/api-get-account-tokenlogin-do.md"}
reading_note: "文档记录不等于当前部署能力；以实际版本、授权模块与配置为准。保留原文的可选、限制及待确认说明，勿补猜接口。 / Documentation is not a guarantee for every deployment. Preserve optional-module requirements, limitations and unresolved API contracts."
---

# JWT Token 网页登录

`GET /account/tokenLogin.do`

用于在已开启 JWT 登录的私有化环境中，以指定用户身份进入网盘网页。它建立网页访问会话，不等于取得业务 API 的 access_token。

## URL 查询参数

| 参数 | 要求与说明 |
| --- | --- |
| `userToken` | 必填；可信服务端生成的签名 JWT，携带用户的 `email`、`phone` 或 `babelId` 信息 |
| `fileId` | 可选；进入指定文件或文件夹，不填进入用户根目录 |
| `onlyFileList` | 值为 `1` 时，仅显示文件列表页面，隐藏其他频道 |
| `closeTitleBar` | 可选；1 隐藏标题栏，0 不隐藏，默认 0 |
| `disableEntMark` | 可选；1 隐藏企业标识，默认 0 |
| `disableUserMark` | 可选；1 隐藏用户设置入口，默认 0 |
| `defaultLang` | 可选；cn 中文、en 英文、zh-HK 繁体，默认 cn |
| `defaultClrTheme` | 可选；normal 标准、dark 深色，默认 normal |

示例：

```text
/account/tokenLogin.do?userToken=<JWT_TOKEN>&fileId=<FILE_ID>&onlyFileList=1
```

## 用户身份与安全

已确认可通过邮箱 `email`、手机号 `phone` 或工号 `babelId` 标识用户。这些用户信息由 `userToken` 中的 JWT 携带，与用于开发者授权的 `jwt_token` 区分。

当前部署已确认的邮箱登录 claims 如下（身份及时间为示例值）：

```json
{
  "duration": 60,
  "payload": {"email": "user@example.com"},
  "time": 1790000000000
}
```

`time` 是生成 `userToken` 时的 Unix 毫秒时间戳，`duration` 是该 JWT 的有效秒数；样例 `60` 表示 60 秒，不代表固定值或默认值。邮箱字段位于 `payload.email`，不要把手机号或工号填入邮箱字段。本次结构确认适用于当前部署，详见 [JWT 声明结构与有效期](https://www.babel.cc/public/babelwiki/zh/developer-api-overview.html#jwt-contract-status)。

JWT 在此用于签名认证，不是载荷加密。仅在可信服务端生成短期凭证；使用 HTTPS，妥善控制访问日志中的 URL，避免泄露 Token。登录身份必须经过业务系统授权校验，不能直接接受任意前端指定的用户。

隐藏标题栏、企业标识或用户入口只是界面选项，不会提高调用权限，也不能替代文件访问控制。