跳转到内容
Multilogin帮助中心

如何登录并刷新 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)”获取新令牌,无需重新登录。

谁可以使用自动化?

开始前的准备

你需要安装 Postman,并导入 Multilogin API集合:

  1. 安装 Postman
  2. 打开 Multilogin API文档,点击“Run in Postman”
  3. 点击“Import”
Multilogin API 文档旁显示 Postman Import Collection 对话框,突出显示 Run in Postman 和 Import。

如何通过 API 登录

只有集成需要直接登录,而不由人工从 Multilogin 控制面板复制令牌时,才使用 API登录。常规自动化请改用自动化令牌。它的有效期更长,无需每 30 分钟刷新一次。

第 1 步:生成密码的 MD5 哈希值

“User Sign In”请求需要 Multilogin 密码的 MD5 哈希值,而不是密码本身。

可以在电脑上使用 Python 3 生成。开始前,请确认已安装 Python。在 Windows 上,如有需要,可以使用 py代替 python3。

  1. 打开 Terminal(macOS/Linux)或 PowerShell(Windows)
  2. 运行此命令:
python3 -c "import hashlib, getpass; print(hashlib.md5(getpass.getpass('Password: ').encode()).hexdigest())"
  1. 按提示输入 Multilogin 密码
  2. 复制生成的哈希值

也可以使用在线 MD5 生成器
但这样需要在第三方网站上输入 Multilogin 密码。我们建议在自己的电脑上生成哈希值。使用在线工具的风险由你自行承担。

第 2 步:登录并获取令牌

使用邮箱和密码哈希值通过 API登录。你会获得用于发送请求的普通 API 令牌,以及用于续期访问的刷新令牌。

  1. 在 Postman 中,打开“Profile Access Management” → “User Sign In”
  2. 进入“Body”,输入邮箱和密码哈希值
{
  "email": "[email protected]",
  "password": "your_md5_password_hash"
}
  1. 点击“Send”

成功登录后会返回两个值:

  • token:普通 API令牌,有效期为 30 分钟
  • refresh_token:可用来获取新的普通 API令牌,无需重新登录

请妥善保管这两个值,不要泄露。下一步需要用到它们。

Postman User Sign In 请求,Body 中包含 email 和 password,响应中显示 token 和 refresh_token。

如何刷新普通 API令牌

普通 API令牌会在 30 分钟后过期。使用 “User Refresh Token (Switch Workspace)”可获取新令牌,无需重新登录。

你需要将普通 API令牌填入“Authorization”,将刷新令牌填入“Body”。

什么时候需要 workspace_id?
刷新当前工作区的令牌时,除非启用了严格模式,否则可以不填 workspace_id。要切换工作区,请在请求体中添加 workspace_id。可以通过 “User Workspaces”查找 ID。

  1. 在 Postman 中,打开“Profile Access Management” → “User Refresh Token (Switch Workspace)”
  2. 打开“Authorization”
  3. 选择“Bearer Token”
  4. 输入 token,此值来自 “User Sign In”
  5. 打开“Body”,输入邮箱和 refresh token
{
  "email": "[email protected]",
  "refresh_token": "your_refresh_token"
}
  1. 点击“Send”

成功响应会返回新的 token和 refresh_token。之后的请求请使用这些新值。

Postman User Refresh Token (Switch Workspace) 请求,显示 Bearer Token 授权及包含 email 和 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 请求,建议改用自动化令牌。

随时掌握最新动态

获取最新动态,交流经验,了解实际使用场景。

获取产品更新Telegram频道向其他用户提问Telegram聊天查看使用场景Discord社区