Популярные темы: Multilogin X, Multilogin 6,
CLI и Local API
Содержание
Multilogin поддерживает Command Line Interface (CLI) и Local API. В этой статье представлены основные команды CLI, эндпоинты Local API, а также рассмотрены примеры использования CLI.
3 шага для начала использования Local API:
- Предопределите порт, который будет использовать приложение.
- Запустите Multilogin вручную или с использованием CLI.
- Используйте эндпоинты Local API.
Определение порта Multilogin
Для использования Local API необходимо предопределить порт.
- Пройдите в папку .multiloginapp.com и откройте файл app.properties (папка может быть скрытой, в зависимости от настроек вашей ОС):
- Windows: C:\Users\%username%\.multiloginapp.com.
- Linux: /home/%username%/.multiloginapp.com.
- macOS: /Users/%username%/.multiloginapp.com.
Для отображения этой папки на устройствах Mac можно использовать следующие комбинации клавиш:
- Cmd + Shift + H
— для отображения папки текущего пользователя.
- Cmd + Shift + .
(точка) — для отображения скрытых папок и файлов.
2. Откройте файл app.properties в любом текстовом редакторе.
3. Добавьте следующую строку: multiloginapp.port=[PORT_NUMBER]
.
Номер порта должен находиться в диапазоне от 10000 до 49151.
4. Сохраните файл app.properties.
В дальнейшем вы можете обращаться к Multilogin используя выбранный вами порт.
Command Line Interface (CLI)
Прежде чем вводить последующие команды, убедитесь, что командная строка открыта в основной директории Multilogin.
Для Multilogin версии 6.0 и выше
- Windows: C:\Program Files (x86)\Multilogin\headless
- macOS: /Applications/multilogin.app/Contents/MacOS/multilogin.app/Contents/MacOS
- Linux: /opt/Multilogin/headless
Для Multilogin версии 5.19 и ниже
- Windows: C:\Program Files (x86)\Multilogin
- macOS: /Applications/multilogin.app/Contents/MacOS
Если вы работаете на UNIX системе, удостоверьтесь, что у .sh файла имеются права на запуск. Сделать это можно при помощи команды chmod +x
(например, chmod +x headless.sh
).
Запуск Multilogin без UI
Windows
headless.exe
Linux/MacOS
./headless.sh
Запуск Multilogin без UI на определённом порту (35000 используется в качестве примера)
Windows
headless.exe -port 35000
Linux/MacOS
./headless.sh -port 35000
Обратите внимание: Multilogin можно использовать в режиме headless, но сами браузерные профили открываются в обычном виде (не headless). Для использования профилей понадобится ОС с графическим интерфейсом.
Вход в аккаунт Multilogin
Windows
cli.exe -login -u user@example.com -p password123
Linux/MacOS
./cli.sh -login -u user@example.com -p password123
Local API
Эндпоинты Local API доступны в Multilogin версии 5.4 и выше.
После того как вы запустили Multilogin вручную либо с помощью CLI, вы можете работать с эндпоинтами Local API. Local API дает доступ к созданию и изменению браузерных профилей Multilogin c помощью кода, а также управлению ими. Помимо этого, доступны получение списка всех профилей, добавление профилей в группы и другие действия.
Эндпоинты Local API
Эндпоинты Local API доступны в нашей Swagger документации (OpenAPI Specification).
Протестируйте наш пример кода
Примеры кода для запуска существующих браузерных профилей Multilogin и выполнения простой автоматизации Selenium и Puppeteer:
Типы подписок
Local API доступна только для пользователей с подписками Scale и Custom Scale, и некоторые эндпоинты имеют ограничения на количество запросов в минуту.
При попытке воспользоваться API на подписке, не предоставляющей к ней доступ, сервер ответит следующей ошибкой:
{"status": "ERROR", "message": "Forbidden", "value": "Forbidden"}
Ограничения по количеству запросов
Ограничения применяются ко всем типам подписок. Они делятся на два типа:
- Запросы, возвращающие списки — 1 запрос в минуту.
- Все остальные запросы — 10 запросов в минуту.
При достижении лимита сервер будет отвечать на запрос следующей ошибкой:
{"status":"ERROR","value":"rate limit exceeded."}
Если API возвращает ошибку, включается 6-ти секундное ограничение, в течение которого любые запросы к API будут отклонены.