Multilogin API 速率限制和响应代码
在 Multilogin 中,API 速率限制表示每分钟可以发送多少次请求,而响应代码则表示请求是否成功,或出现了什么问题。
➡️ 在 Postman 中打开“Multilogin API”collection → 选择一个请求 → 点击“Send” → 查看响应状态和响应正文。
如果需要定期使用 API 自动化,请使用自动化令牌。与普通 API 令牌相比,它的有效期更长,并且每分钟允许发送更多请求。普通 API 令牌的有效期为 30 分钟。
谁可以使用自动化功能?
- 👨💻 账号所有者和所有团队成员(可使用的功能取决于角色)
- 💰 适用于 Pro 10 及更高方案
不同类型的 API 令牌有什么区别?
Multilogin 使用三种令牌来处理不同的身份验证任务。
- 自动化令牌:使用 “Workspace Automation Token” 生成。推荐用于定期自动化,可自定义有效期,并使用当前方案对应的 RPM 限制
- 普通 API 令牌:可以在 Multilogin 的“信息” → “API 令牌”中复制,也可以通过 “User Sign In” 获取。有效期为 30 分钟,速率限制低于自动化令牌
- 刷新令牌:由 “User Sign In” 返回。将其用于 “User Refresh Token (Switch Workspace)”,无需重新登录即可获取新的普通 API 令牌
刷新令牌只能用于获取新的普通 API 令牌。不能使用刷新令牌发送 API 请求,也不能用它续期自动化令牌。
如果自动化令牌已过期,请使用有效的普通 API 令牌生成一个新的自动化令牌。
每分钟可以发送多少次 API 请求?
Multilogin 使用 RPM(每分钟请求数)计算 API 限制。每次 API 请求都会计入限制,无论您是在管理浏览器配置文件还是其他 Multilogin 资源。
自动化令牌的限制如下:
- Pro 10:50 RPM
- Pro 50:100 RPM
- Pro 100:100 RPM
- Business 300:标准方案为 100 RPM,更高级别的 Business 方案可能使用自定义限制
您可以在 Multilogin 定价页面查看当前限制。
团队成员是否共享同一个 API 限制?
是。同一工作台中的所有成员共享一个 RPM 限制,即使他们使用不同的自动化脚本或令牌也是如此。
例如,如果您使用 Pro 100,整个工作台每分钟最多可以发送 100 次请求。如果两名团队成员在同一分钟内分别发送 40 次请求,就可能超过该限制。
达到 API 限制后会发生什么?
超过 RPM 限制时,Multilogin 会返回 429 – Too Many Requests。
请等待限制重置后再发送更多请求。如果经常遇到这种情况,可以尝试将请求分散发送,而不是一次性全部运行。
需要更高的每分钟请求数?查看可用方案,或联系 Multilogin 支持了解可选方案。
API 响应代码是什么意思?
每个 Multilogin API 请求都会返回一个 HTTP 状态码。它可以告诉您请求是否成功,或是否有需要处理的问题。
以下是最常见的状态码:
-
200 – OK:请求成功 -
201 – Created:内容已成功创建 -
400 – Bad Request:请求中缺少信息或某些内容不正确,请检查必填参数和值 -
401 – Unauthorized:令牌可能缺失、不正确或已过期,请检查“Authorization” → “Bearer Token” -
403 – Forbidden:您没有执行此操作的权限,请检查您的工作台角色 -
404 – Not Found:找不到请求的资源,请检查文档中的 endpoint 以及请求中的 ID -
429 – Too Many Requests:已达到 API 速率限制,请等待限制重置 -
500 – Internal Server Error:服务器出现问题,请稍后重试。如果问题持续存在,请联系支持团队
您可以参考 Multilogin API 文档,检查请求所需的参数和格式。
遇到错误?
也请检查响应正文。里面通常会包含更具体的信息,帮助您找到问题。
download_browser_profile_metadata 返回 200 是什么意思?
这表示 Multilogin 已成功从服务器获取浏览器配置文件数据,供后续使用。
这是正常情况,不是错误。无需进行任何修复。