Clicky

CLI и Local API

Обновлено 4 months ago от Annes Silde

Статьи по теме

Multilogin поддерживает Command Line Interface (CLI) и Local API. В этой статье представлены основные команды CLI, эндпоинты Local API, а также рассмотрены примеры использования CLI.

3 шага для начала использования Local API:

1. Предопределите порт, который будет использовать приложение.
2. Запустите Multilogin вручную или с использованием CLI.
3. Используйте эндпоинты Local API.

Определение порта Multilogin

Для использования Local API необходимо предопределить порт.

  1. Пройдите в папку .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 + . (точка) — для отображения скрытых папок и файлов.
  1. Откройте файл app.properties в любом текстовом редакторе.
  2. Добавьте следующую строку: multiloginapp.port=[PORT_NUMBER].
Номер порта должен находиться в диапазоне от 10000 до 49151.
  1. Сохраните файл 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 [email protected] -p password123

Linux/MacOS

./cli.sh -login -u [email protected] -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 будут отклонены.
Видео по теме


Наши новости, полезные статьи и советы вы найдёте здесь


Вам удалось решить проблему?