Лимиты Multilogin API и коды ответов
В Multilogin есть лимит на количество API-запросов в минуту. А код ответа показывает, прошел запрос или произошла ошибка.
➡️ В Postman откройте коллекцию «Multilogin API» → выберите запрос → нажмите «Send» → посмотрите код и тело ответа.
Для регулярной автоматизации лучше использовать токен автоматизации. Он работает дольше обычного API-токена и позволяет отправлять больше запросов в минуту.
Кому доступна автоматизация?
- 👨💻 Владельцу аккаунта и всем участникам. Доступ к отдельным функциям зависит от роли.
- 💰 На подписке Pro 10 и выше.
Какие токены используются в API?
В Multilogin есть три типа токенов:
- Токен автоматизации: создается через «Workspace Automation Token». Лучше всего подходит для регулярной автоматизации. Вы сами задаете срок его действия.
- Обычный API-токен: можно скопировать в Multilogin через «Info» → «API token» или получить через «User Sign In». Он работает 30 минут и имеет более низкий лимит запросов.
- Токен обновления: вы получите его после запроса «User Sign In». Используйте его с «User Refresh Token (Switch Workspace)», чтобы получить новый обычный API-токен без повторного входа.
Токен обновления нужен только для получения нового обычного API-токена. Отправлять с ним API-запросы или продлевать токен автоматизации нельзя.
Если токен автоматизации истек, создайте новый с помощью действующего обычного API-токена.
Сколько API-запросов можно отправлять?
Лимит считается в RPM, requests per minute, то есть запросах в минуту.
Каждый API-запрос учитывается в лимите, независимо от того, работаете вы с облачными телефонами, браузерными профилями или другими функциями Multilogin.
Лимиты для токенов автоматизации:
- Pro 10: 50 RPM.
- Pro 20: 75 RPM.
- Pro 50: 100 RPM.
- Business: 100 RPM на стандартных подписках. Для более крупных подписок лимит может быть другим.
Актуальные лимиты можно проверить на странице подписок Multilogin.
Участники делят один лимит API?
Да. У всего проекта один общий лимит RPM, даже если участники используют разные токены или скрипты.
Например, на Pro 20 доступно 75 запросов в минуту. Если два участника отправят по 40 запросов за одну минуту, общий лимит будет превышен.
Что будет, если превысить лимит?
Multilogin вернет 429 – Too Many Requests.
Подождите, пока лимит обновится, и попробуйте снова. Если ошибка появляется часто, распределите запросы по времени, а не отправляйте все сразу.
Нужно больше запросов в минуту? Посмотрите другие подписки или напишите в поддержку Multilogin.
Что означают коды ответов API?
Каждый 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 успешно получил данные браузерного профиля с сервера для дальнейшей работы.
Это не ошибка. Ничего исправлять не нужно.