Multilogin API 速率限制与响应代码
在 Multilogin 中,API 速率限制规定每分钟可发送的请求数量,响应代码则说明请求是否成功,或哪里出现问题。
➡️ 在 Postman 中打开“Multilogin API”集合→选择请求→点击“Send”→查看响应状态和响应体。
经常进行 API 自动化时,请使用自动化令牌。与 30 分钟后过期的普通 API 令牌相比,它的有效期更长,每分钟允许的请求也更多。
谁可以使用自动化?
- 👨💻 账户所有者和所有团队成员(功能访问权限取决于角色)
- 💰 适用于 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 以 API 请求的 RPM(每分钟请求数)衡量限制。无论管理 Android 云手机、浏览器配置文件还是其他 Multilogin 资源,每个 API 请求都会计入限制。
自动化令牌的限制如下:
- Pro 10:50 RPM
- Pro 20:75 RPM
- Pro 50:100 RPM
- Business:标准套餐为 100 RPM,更高级别的 Business 套餐可能有自定义限制
你可以在Multilogin 价格页面查看当前限制。
团队成员共享 API 限制吗?
是的。同一个工作区的所有人共享一个 RPM 限制,即使使用不同的自动化脚本或令牌也是如此。
例如,Pro 20 的工作区每分钟最多发送 75 个请求。如果两位成员在同一分钟内各发送 40 个请求,就可能超过限制。
达到 API 限制后会怎样?
超过 429 – Too Many Requests 对应的 RPM 限制时,Multilogin 会返回此响应。
请等待限制重置后再发送请求。如果经常出现这种情况,请分散请求时间,避免全部同时运行。
需要提高每分钟请求数?请查看可用套餐,或联系Multilogin 支持团队了解选项。
API 响应代码是什么意思?
每个 Multilogin API 请求都会返回一个 HTTP 状态码,告诉你请求是否成功,或是否有问题需要处理。
常见代码如下:
-
200 – OK:请求成功 -
201 – Created:已成功创建资源 -
400 – Bad Request:请求中有内容缺失或不正确,请检查必填参数和值 -
401 – Unauthorized:令牌可能缺失、不正确或已过期,请检查“Authorization”→“Bearer Token” -
403 – Forbidden:你没有执行此操作的权限,请检查工作区角色 -
404 – Not Found:未找到请求的资源,请检查文档中的端点以及请求中的各个 ID -
429 – Too Many Requests:已达到 API 速率限制,请等待重置 -
500 – Internal Server Error:服务器出现问题,请稍后重试;如果问题持续,请联系支持团队
你可以对照Multilogin API 文档中的必填参数和格式检查请求。
出现错误?
也请查看响应体。它通常包含更具体的消息,有助于找到原因。
download_browser_profile_metadata 返回 200 是什么意思?
这表示 Multilogin 已成功从服务器获取浏览器配置文件数据,供后续使用。
这是正常情况,不是错误。无需进行任何修复。