如何登录并刷新 Multilogin API 令牌
对于常规 Multilogin API自动化,建议使用自动化令牌。它的有效期更长,无需每 30 分钟刷新一次。只有集成需要通过 API自动登录,而不由人工从 Multilogin 控制面板复制令牌时,才使用这种登录方法。
➡️ 在 Postman 中,进入“Profile Access Management” → “User Sign In” → 输入邮箱和密码的 MD5 哈希值 → 点击“Send”。
“User Sign In”请求会返回普通 API令牌和刷新令牌。之后可以使用 “User Refresh Token (Switch Workspace)”获取新令牌,无需重新登录。
谁可以使用自动化?
- 👨💻 账户所有者和所有团队成员(功能访问权限取决于角色)
- 💰 适用于Pro 10 及以上套餐
开始前的准备
如何通过 API 登录
只有集成需要直接登录,而不由人工从 Multilogin 控制面板复制令牌时,才使用 API登录。常规自动化请改用自动化令牌。它的有效期更长,无需每 30 分钟刷新一次。
第 1 步:生成密码的 MD5 哈希值
“User Sign In”请求需要 Multilogin 密码的 MD5 哈希值,而不是密码本身。
可以在电脑上使用 Python 3 生成。开始前,请确认已安装 Python。在 Windows 上,如有需要,可以使用 py代替 python3。
- 打开 Terminal(macOS/Linux)或 PowerShell(Windows)
- 运行此命令:
python3 -c "import hashlib, getpass; print(hashlib.md5(getpass.getpass('Password: ').encode()).hexdigest())"- 按提示输入 Multilogin 密码
- 复制生成的哈希值
也可以使用在线 MD5 生成器
但这样需要在第三方网站上输入 Multilogin 密码。我们建议在自己的电脑上生成哈希值。使用在线工具的风险由你自行承担。
第 2 步:登录并获取令牌
使用邮箱和密码哈希值通过 API登录。你会获得用于发送请求的普通 API 令牌,以及用于续期访问的刷新令牌。
- 在 Postman 中,打开“Profile Access Management” → “User Sign In”
- 进入“Body”,输入邮箱和密码哈希值
{
"email": "[email protected]",
"password": "your_md5_password_hash"
}- 点击“Send”
成功登录后会返回两个值:
token:普通 API令牌,有效期为 30 分钟refresh_token:可用来获取新的普通 API令牌,无需重新登录
请妥善保管这两个值,不要泄露。下一步需要用到它们。

如何刷新普通 API令牌
普通 API令牌会在 30 分钟后过期。使用 “User Refresh Token (Switch Workspace)”可获取新令牌,无需重新登录。
你需要将普通 API令牌填入“Authorization”,将刷新令牌填入“Body”。
什么时候需要 workspace_id?
刷新当前工作区的令牌时,除非启用了严格模式,否则可以不填 workspace_id。要切换工作区,请在请求体中添加 workspace_id。可以通过 “User Workspaces”查找 ID。
- 在 Postman 中,打开“Profile Access Management” → “User Refresh Token (Switch Workspace)”
- 打开“Authorization”
- 选择“Bearer Token”
- 输入
token,此值来自 “User Sign In” - 打开“Body”,输入邮箱和
refresh token
{
"email": "[email protected]",
"refresh_token": "your_refresh_token"
}- 点击“Send”
成功响应会返回新的 token和 refresh_token。之后的请求请使用这些新值。

常见问题
为什么出现“Missing authorization header”?
刷新请求需要在“Authorization” → “Bearer Token”中填写普通 API令牌。
请确认添加的是普通 token,而不是 refresh_token。刷新令牌应放在 JSON 请求体中。
为什么出现“Wrong workspace user”?
检查请求中的 workspace_id。
- 如果刷新的是当前工作区的令牌,请从请求体移除
workspace_id,除非严格模式要求填写 - 如果要切换工作区,请使用账户有权访问的真实工作区 ID
不要在请求中保留 Postman 的示例值 <string>。
可以用这种方法刷新自动化令牌吗?
不可以。刷新请求适用于普通 API令牌,不适用于自动化令牌。
自动化令牌过期后,请生成新令牌。
为什么 Postman 返回“Wrong JWT token”?
你的 API令牌可能已过期,或未填入授权设置。获取新令牌,并添加到“Authorization” → “Bearer Token”。请确认令牌属于正确的 Multilogin 工作区。
我的 API令牌有效期是多久?
普通 API令牌的有效期为 30 分钟。对于长时间运行或重复发送的 API 请求,建议改用自动化令牌。
