对于常规的 Multilogin API 自动化，使用一个 自动化令牌。它的有效期更长，因此您不需要每30分钟刷新一次令牌。仅在您的集成需要自动登录时使用 API 登录，而不需要有人从 Multilogin 控制面板复制令牌。

➡️ 在 Postman 中，转到“配置文件访问管理” → “用户登录” → 输入您的电子邮件和 MD5 密码哈希 → 点击“发送”。

“用户登录”请求将为您提供一个常规 API 令牌和一个 刷新令牌。然后，您可以使用 “用户刷新令牌（切换 工作台）” 来获取新的令牌，而无需再次登录。

开始之前

Install Postman CN

您需要 Postman 并导入 Multilogin API 集合：

1. 安装 Postman
2. 打开 Multilogin API 文档 并点击“Run in Postman”
3. 点击“Import”

如何通过 API

仅在您的集成需要在没有人从 Multilogin 控制面板复制令牌的情况下登录时，使用 API 登录。对于常规自动化，请使用一个 自动化令牌。它的有效期更长，不需要每30分钟刷新一次。

步骤 1：生成您的 MD5 密码哈希

“用户登录” 请求需要您的 Multilogin 密码的 MD5 哈希，而不是密码本身。

您可以在计算机上使用 Python 3 生成它。确保在开始之前已安装 Python。在 Windows 上，如果需要，请使用 py 而不是 python3。

1. 打开终端（macOS/Linux）或 PowerShell（Windows）
2. 运行此命令：

python3 -c "import hashlib, getpass; print(hashlib.md5(getpass.getpass('Password: ').encode()).hexdigest())"

3. 在提示时输入您的 Multilogin 密码
4. 复制生成的哈希

步骤 2：登录并获取您的令牌

使用您的电子邮件和密码哈希通过 API 登录。您将获得一个常规 API 令牌以进行请求，以及一个刷新令牌以更新访问权限。

1. 在 Postman 中，打开“配置文件访问管理” → “用户登录”
2. 转到“主体”，输入您的电子邮件和密码哈希

{
  "email": "[email protected]",
  "password": "your_md5_password_hash"
}

3. 点击“发送”

成功登录将返回两个值：

• token: 您的常规 API 令牌，有效期为 30 分钟
• refresh_token: 让您在不再次登录的情况下获取另一个常规 API 令牌

请保留这两个值的私密性。您将在下一步中需要它们。

如何刷新您的常规 API 令牌

常规 API 令牌在 30 分钟后过期。使用 “用户刷新令牌（切换 工作台）” 来获取新的令牌，而无需再次登录。

您需要在“授权”中输入您的常规 API 令牌，以及在“主体”中输入您的刷新令牌。

1. 在 Postman 中，打开“配置文件访问管理” → “用户刷新令牌（切换 工作台）”
2. 打开“授权”
3. 选择“Bearer Token”
4. 输入由 “用户登录” 返回的 token
5. 打开“主体”，输入您的电子邮件和 刷新令牌

{
  "email": "[email protected]",
  "refresh_token": "your_refresh_token"
}

6. 点击“发送”

成功响应将返回一个新的 token 和 refresh_token。使用新值进行未来的请求。

常见问题

为什么我会收到“缺少授权头”？

刷新请求需要您的常规 API 令牌在“授权” → “Bearer Token” 下。

确保您添加的是常规 token，而不是 refresh_token。刷新令牌应放在 JSON 主体中。

为什么我会收到“错误的 工作台 用户”？

检查请求中的 workspace_id。

• 如果您正在为当前 工作台 刷新令牌，请删除 workspace_id，除非严格模式要求它
• 如果您正在切换 工作台，请使用您的帐户可以访问的真实工作台 ID

请不要在请求中保留 Postman 的示例值 <string>。

我可以使用此方法刷新自动化令牌吗？

不可以。刷新请求适用于常规 API 令牌，而不适用于自动化令牌。

如果您的自动化令牌过期， 请生成一个新的。

为什么 Postman 返回 401 – 错误的 JWT 令牌？

您的 API 令牌可能已过期或可能在授权设置中缺失。获取一个新的令牌并在“授权” → “Bearer Token” 下添加它。确保该令牌属于正确的 Multilogin 工作台。

我的 API 令牌能持续多久？

常规 API 令牌的有效期为 30 分钟。对于运行时间更长或重复的 API 请求，我们建议使用一个 自动化令牌。