CLI и Local API
Обновлено 4 weeks ago
от
Annes Silde
Статьи по теме
Multilogin поддерживает команды Command Line Interface (CLI) и Local API. Данное руководство представит основные команды CLI, эндпойнты Local API. Также будут рассмотрены примеры использования CLI.
1. Предопределите порт, который будет использовать приложение.
2. Запустите Multilogin вручную или с использованием CLI.
3. Используйте эндпойнты Local API.
1. Определение порта Multilogin
Для использования Local API необходимо предопределить порт. Вы можете сделать это следующим образом:
- Пройдите в директорию .multiloginapp.com и откройте файл app.properties (папка может быть скрытой, в зависимости от настроек вашей ОС):
- Windows: C:\Users\%username%\.multiloginapp.com.
- Mac OS: /Users/%username%/.multiloginapp.com.
-
Cmd + Shift + H – для отображения папки текущего пользователя.-
Cmd + Shift + . (точка) - для отображения скрытых папок и файлов.- Linux: /home/%username%/.multiloginapp.com.
- Откройте файл app.properties в любом текстовом редакторе.
- Добавьте следующую строку:
multiloginapp.port=[PORT_NUMBER].
- Сохраните файл app.properties
В дальнейшем вы можете обращаться к Multilogin используя выбранный вами порт.
2. CLI
Для 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
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:
Windows
cli.exe -login -u [email protected] -p password123
Linux/MacOS
./cli.sh -login -u [email protected] -p password123
3. Local API
После того как вы запустили Multilogin вручную либо с помощью CLI, вы можете работать с эндпойнтами Local API. Local API предоставляет доступ к созданию и изменению браузерных профилей Multilogin c помощью кода, а также управлению ними. Помимо этого, доступны получение списка всех профилей, добавление профилей в группы, и другие действия.
Эндпойнты Local API
Эндпойнты Local API доступны в нашей Swagger документации (OpenAPI Specification).
Протестируйте наш пример кода
Примеры кода для запуска существующих браузерных профилей Multilogin и выполнения простой автоматизации Selenium и Puppeteer:
Типы подписок
Local API доступна только для пользователей с подписками Automate или Scale, и некоторые эндпойнты имеют ограничения на количество запросов в минуту.
Если пользователь пытается воспользоваться API на подписке, не предоставляющей доступ, сервер ответит следующей ошибкой:
{"status": "ERROR", "message": "Forbidden", "value": "Forbidden"}Ограничения по количеству запросов
Ограничения применяются ко всем типам подписок. Они делятся на два типа:
- Запросы возвращающие списки - 1 запрос в минуту
- Все остальные запросы - 10 запросов в минуту
При достижении лимита, сервер будет отвечать на запрос со следующей ошибкой:
{"status":"ERROR","value":"rate limit exceeded."}В случае, если API возвращает ошибку, включается 6-ти секундное ограничение, в течении которого любые запросы к API будут отклонены.
Для дополнительной информации, свяжитесь с нашей технической поддержкой.