Как управлять облачными телефонами с помощью API
Вы можете использовать Multilogin API для автоматического управления облачными телефонами на основе Android. Создавайте, обновляйте, запускайте, останавливайте, организуйте и проверяйте облачные телефоны, не выполняя эти действия вручную в панели управления. Это полезно для команд и разработчиков, которые управляют множеством облачных телефонов или подключают Multilogin к своим собственным автоматизированным рабочим процессам.
➡️ Чтобы использовать запросы API для облачных телефонов, откройте коллекцию Postman, связанную с управлением мобильными профилями → Найдите нужный запрос → Запустите его в вашем скрипте или Postman.
Что API может делать : настройка облачного телефона, статус, файлы, приложения, теги, группы и массовые действия.
Что API не делает: контролировать действия внутри приложений Android. Для автоматизации приложений используйте ADB или такие инструменты, как Appium.
Обратите внимание, что это лишь краткий обзор функций, и пояснения по их настройке будут краткими. Предполагается, что вы знаете основы работы с Postman. Рекомендуется ознакомиться со статьями, приведенными ниже, прежде чем переходить к этой.
В документации Multilogin API облачные телефоны Android называются мобильными профилями (mobile profiles).
Запросы сгруппированы по задачам, так что вы можете быстро найти то, что вам нужно. Все они доступны в папке “Mobile Profile Management” в коллекции “Multilogin API”.
Кто может использовать эти API запросы?
- 👨💻 Владелец аккаунта и все участники проекта
- 💰 Доступно на Pro 10, Pro 50, Business 100 и всех подписках Business
Как управлять облачными телефонами
Эти запросы охватывают основные действия с облачными телефонами.
Создание
Эндпоинт: Mobile Profile Create
Создайте один или несколько облачных телефонов без настройки вручную.
Вы можете настроить такие значения, как:
- Название телефона
- Версия Android
- Бренд и модель телефона
- Прокси
- Заметки и теги
- Настройки сети и местоположения
Прокси требуется при создании облачного телефона.
💡 Почему это полезно: создавайте множество облачных телефонов с одинаковыми настройками, не повторяя одну и ту же конфигурацию в приложении.

Запуск
Эндпоинт: Mobile Profile Start
Запрос запускает один или несколько облачных телефонов без графического интерфейса. Это полезно для автоматизации работы, которая не требует смотреть на экран телефона.

Остановка
Эндпоинт: Mobile Profile Stop
Запрос останавливает один или несколько облачных телефонов. Также полезно для автоматизации.

Обновление
Эндпоинт: Mobile Profile Stop
Вы можете обновить конфигурацию облачного телефона, включая его марку и модель телефона, название, прокси, заметки, теги и тип сети. Вам потребуется ID облачного телефона, который вы можете получить в панели управления Multilogin или с помощью GET Mobile Profile List.
💡 Почему это полезно: Это экономит время на массовых обновлениях, так что вам не нужно редактировать каждый облачный телефон вручную в приложении.

Удаление
Эндпоинт: Mobile Profile Delete
Удалите облачные телефоны по их IDs. Используйте это с осторожностью, если вы автоматизируете процесс удаления.
💡 Почему это полезно: Это позволяет вам удалить несколько облачных телефонов в рамках автоматизации. Это может помочь освободить место в вашей подписке, когда вам нужно создать новые облачные телефоны.

Как организовать облачные телефоны
Эти запросы помогут, когда ваш проект начинает расти.
Список
Эндпоинт: Mobile Profile List
Используйте этот запрос, чтобы получить облачные телефоны в вашем проекте.
Ответ на запрос дает вам ID облачного телефона и детали настройки, такие как устройство, местоположение, сеть, прокси и информация о проекте.
💡 Почему это полезно: многие другие запросы требуют ID облачного телефона. Начните здесь, когда у вас его еще нет.
Bearer (или автоматизации) токена достаточно для выполнения запроса.

Проверка статуса
Эндпоинт: Mobile Profile Statuses
Отображает несколько значений статуса облачного телефона, включая статус запуска, время работы, временную метку автоматической остановки и статус ADB.
💡 Почему это полезно: Это позволяет вам отслеживать статус облачного телефона во время автоматизации, особенно когда профили запускаются без графического интерфейса.

Получение/создание группы
Эндпоинт: Mobile Profile Group Get or Create
Эндпоинт возвращает группу облачных телефонов (проект) или создает новую.
💡 Почему это полезно: Эндпоинт показывает, что вы подключены к проектом перед началом работы.

Назначение тегов
Эндпоинт: Mobile File Tag Assign
Вы можете применить до 10 тегов одновременно. Теги общие для браузерных профилей и облачных телефонов. Чтобы найти тег, используйте эндпоинт POST Tag Search. Вам также потребуется ID облачного телефона.
💡 Почему это полезно: Это упрощает автоматическую организацию облачных телефонов и делает управление большим количеством профилей проще.

Удаление тегов
Эндпоинт: Mobile File Tag Unassign
Как и при назначении тегов, вы можете удалить до 10 тегов одновременно. Теги одни и те же как для браузерных профилей, так и дл облачных телефонов. Вы можете обратиться к запросам API, связанными с тегами, в папке управления профилями, например POST Tag Search. Также требуется ID облачного телефона.
💡 Почему это полезно: Это помогает поддерживать вашу организацию облачных телефонов в актуальном состоянии, удаляя теги, которые вам больше не нужны.

Как управлять приложениями на телефонах
Вы также можете использовать API для поиска и установки доступных приложений Android.
Список приложений
Эндпоинт: Mobile App List
Возвращает список приложений из магазина приложений. Ответ дает вам ID приложения и ID версий. Вам понадобятся эти значения для установки приложения.
💡 Почему это полезно: Эндпоинт дает вам ID приложения и версии, необходимые для автоматической установки приложений.

Установка приложений
Эндпоинт: Mobile App Install
Эндпоинт устанавливает приложение массово облачным телефонам во всем проекте. Используйте ID приложения и ID версии. Устанавливает приложение в проект по умолчанию. Вы также можете использовать эндпоинт GET Mobile Profile Group Get or Create.
💡 Почему это полезно: Это позволяет установить одно и то же приложение на несколько облачных телефонов, не настраивая каждый телефон вручную.

Как использовать библиотеку телефонов
Библиотека — это общая облачное хранилище для ваших облачных телефонов.
Используйте эти запросы для загрузки, поиска, организации и удаления файлов.
Список файлов
Эндпоинт: Mobile File List
Получите файлы, хранящиеся в библиотеке. Ответ запроса включает в себя ID файлов, которые вам нужны для запросов, связанных с файлами.

Загрузка файла
Эндпоинт: Mobile File Upload
Загрузите файл в библиотеку облачного телефона. Вы можете затем использовать загруженный файл в облачных телефонах.
Примечание: вы можете загрузить файлы через Postman (как указано на скриншоте).
💡 Почему это полезно: Это позволяет вам автоматически добавлять файлы в библиотеку, чтобы ваши облачные телефоны могли получить к ним доступ во время работы.

Удаление файлов
Конечная точка: Mobile File Delete
Удалите один или несколько файлов библиотеки по их ID. Получите ID сначала с помощью GET Mobile File List.
💡 Почему это полезно: Это упрощает автоматическую очистку файлов библиотеки, когда они больше не нужны.

Примечание: удаление происходит немедленно и не может быть отменено.
Назначение тегов файлам
Эндпоинт: Mobile File Tag Assign
Вы можете применить до 10 тегов одновременно. Теги такие же, как для браузерных профилей и облачных телефонов. Вы можете обратиться к запросам API, связанным с тегами, в папке Profile Management, например POST Tag Search. Также требуется ID файла.
💡 Почему это полезно: Это помогает вам автоматически организовывать файлы библиотеки, особенно когда вы управляете многими загруженными файлами.

Снятие тегов с файлов
Эндпоинт: Mobile File Tag Unassign
Удалите теги из файла библиотеки. Теги такие же, как для профилей браузера и облачных телефонов. Вы можете обратиться к запросам, связанным с тегами, в папке Profile Management, например POST Tag Search. Также требуется ID файла (POST Mobile File List).
💡 Почему это полезно: Эндпоинт помогает поддерживать порядок в файлах библиотеки, удаляя теги, которые больше не актуальны.

Как массово управлять телефонами
Эти запросы помогают, когда вы работаете с большим количеством облачных телефонов.
Экспорт
Эндпоинт: Mobile Profile Export
Запрос экспортирует данные облачного телефона в файл .xlsx. Вы можете экспортировать до 200 облачных телефонов за раз.
Примечание: Результат представлен в виде файла. Если вы используете Postman, нажмите на меню с тремя точками (рядом с кнопкой «Save Response») и выберите «Save».
💡 Почему это полезно: Это экономит время, когда вам нужны данные облачного телефона для отчетности, резервного копирования или управлением облачных телефонов. больших количествах.

Импорт
Скачать шаблон импорта
Эндпоинт: Import Template Download
Скачивает шаблон .xlsx для массового импорта облачных телефонов. Заполните данные, затем проверьте файл с помощью следующего эндпоинта: POST Import File Validate
Примечание: Результат представлен в виде файла. Если вы используете Postman, нажмите на меню с тремя точками (рядом с кнопкой «Save Response») и выберите «Save».
💡 Почему это полезно: Это дает вам правильную структуру файла для массового импорта облачных телефонов, что помогает уменьшить ошибки форматирования.

Проверка файла импорта
Эндпоинт: Import File Validate
Проверьте ваш .xlsx файл импорта перед его использованием.
Вы можете создать файл из:
💡 Почему это полезно: проверка помогает избежать ошибок при массовом импорте.

Передача
Эндпоинт: Mobile Profile Transfer
Этот запрос позволяет вам передать профили другому участнику вашего проекта. Вы можете передать до 200 профилей за раз (также применяются ограничения вашей текущей подписки).
Примечание: передача является постоянной и не может быть отменена.
💡 Почему это полезно: полезно, когда вы перемещаете облачные телефоны между членами команды или переорганизуете права собственности.

Как проверить лимиты и значения настройки
Эти вспомогательные запросы дают вам значения, необходимые для настройки облачного телефона.
Лимит использования телефона
Эндпоинт: Mobile Profile Limit
Проверьте лимит минут облачного телефона вашего проекта.
Ответ показывает ваши общие доступные минуты, сколько минут вы уже использовали и сколько еще осталось.

Проверка прокси
Эндпоинт: Mobile Proxy Check
Запрос проверяет доступность прокси и предоставляет дополнительную информацию, такую как IP, геолокация, часовой пояс и провайдер интернет-услуг.
💡 Почему это полезно: это позволяет вам протестировать прокси перед использованием его с облачным телефоном, что помогает заранее выявить проблемы с подключением или местоположением.

Список штатов по странам
Эндпоинт: States by Country
Используйте код страны, чтобы получить список штатов. Вы можете использовать их для создания облачных телефонов.
💡 Почему это полезно: это дает вам действительные значения штатов или регионов для настройки данных о местоположении облачного телефона.

Список городов по штатам
Эндпоинт: Cities by State
Запрос возвращает список городов по штатам или регионам. Вы можете использовать значения штатов с этим эндпоинтом: GET States by Country.
💡 Почему это полезно: это дает вам действительные значения городов для использования при настройке данных о местоположении облачного телефона.

Список брендов и моделей телефонов
Эндпоинт: Phone Brand List
Получите поддерживаемые бренды и модели телефонов для версии Android. Используйте возвращенные значения, когда вы настраиваете создание облачных телефонов.
💡 Почему это полезно: это дает вам поддерживаемые значения бренда и модели, так что вы можете использовать действительные настройки устройства при создании облачных телефонов.

Часто задаваемые вопросы
Что означает “мобильный профиль” в API?
Мобильный профиль — это облачный телефон Android в Multilogin.
В API используется термин “мобильный профиль” (mobile profile) во многих названиях запросов и параметров.
Нужен ли мне Postman для использования этих запросов?
Нет. Postman полезен для тестирования запросов и проверки ответов без создания полного скрипта.
Вы также можете вызывать Multilogin API запросы из вашей автоматизации.
Какой токен мне использовать?
Обычный токен доступа подходит для API запросов и истекает через 30 минут.
Для более длительных автоматизированных рабочих процессов вы можете создать токен автоматизации с необходимым сроком действия.
Могут ли эти API запросы автоматизировать действия внутри Android-приложений?
Эти запросы в основном помогают вам управлять самими облачными телефонами.
Для автоматизации нативных Android-приложений подключите ваши облачные телефоны через ADB и используйте такие инструменты, как Appium.
Могу ли я создать несколько облачных телефонов Android с помощью API?
Да, запрос на создание мобильного профиля поддерживает создание облачных телефонов без ручной настройки.
Заменяет ли API ADB или Appium?
Нет. API управляет облачными телефонами. Используйте ADB и Appium для действий внутри Android-приложений.
Где я могу найти свой облачный телефон ID?
Используйте запрос GET Mobile Profile List или скопируйте его с панели управления Multilogin.