Перейти к содержимому
MultiloginБаза знаний

Обзор запросов API объектного хранилища

Эндпоинты Object Storage API в Multilogin позволяют загружать, скачивать, удалять, восстанавливать и проверять сохраненные объекты, а также менять их тип хранения. Среди них cookie, расширения, шаблоны профилей, пароли, скрипты автоматизации и шаблоны параметров запуска.

➡️ В Postman откройте «Multilogin API» → «Object Storage» → добавьте токен автоматизации в «Authorization» → «Bearer Token» → выберите нужный эндпоинт. Если действие требует запуска профиля, оставьте приложение Multilogin открытым.

Начните с «Get list of object types», чтобы найти ID типа объекта. Затем используйте нужный эндпоинт для работы с объектом, проверки того, где он используется, просмотра метаданных или статистики, смены типа хранения или управления объектами расширений.

Обратите внимание, что это лишь краткий обзор функций, и пояснения по их настройке будут краткими. Предполагается, что вы знаете основы работы с Postman. Рекомендуется ознакомиться со статьями, приведенными ниже, прежде чем переходить к этой.

Для вашего удобства эндпоинты распределены по категориям. Все они находятся в папке «Object Storage», в коллекции «API Multilogin».

Список типов объектов

Эндпоинт: Get list of object types

Скорее всего, это будет ваш первый запрос API, он вам пригодится в других запросах. Запрос GET List of object types предоставляет различные категории, используемые для классификации объектов. К типам относятся такие категории, как расширения, cookie, шаблоны профилей, пароли, сценарии автоматизации и шаблоны параметров запуска.

Добавьте токен автоматизации в разделе «Authorization» → «Bearer Token».

Запрос Postman GET List of Object Types: выделены Authorization → Bearer Token.

Загрузка, скачивание и удаление объектов

Как загрузить объект

Эндпоинт: Upload Object

С помощью запроса POST Upload Object можно загрузить объект в хранилище. Необходимо указать ID типа объекта (который можно получить из следующего запроса: GET List of object types), путь к объекту (директорию, куда вы поместили свой объект) и тип хранилища (облачное или локальное). Также доступны дополнительные значения, такие как метаданные объекта (описание объекта) и шифрование.

Запрос Postman POST Upload Object: выделены object_type, object_path, storage_type.

Как создать и загрузить объект

Эндпоинт: Create and Upload Object

Запрос POST Create and Upload Object также может помочь с загрузкой файла, но он также предоставляет возможность создания нового файла непосредственно через API. Например, это может быть полезно, если вы экспортировали cookie через API. Он имеет те же параметры, что и POST Upload Object, но помимо этого есть параметры object_name для имени файла и object_extension для расширения файла.

Запрос Postman POST Create and Upload Object: выделены object_name, object_extension.

Как скачать объект

Эндпоинт: Download Object

Если вам нужно загрузить объект из облака, вы можете использовать для этого эндпоинт GET Download Object. Вам потребуется знать ID объекта (вы получите его в ответе во время загрузки объекта или сможете найти его с помощью эндпоинта GET Objects Meta). Замените <id_upload> в строке с эндпоинтом на этот ID.

Запрос Postman GET Download Object: выделены object ID in the endpoint URL.

Как удалить объект

Эндпоинт: Delete Object

Для удаления объектов из хранилища можно использовать команду GET Delete Object. Необходимо указать ID объекта (вы получите его после загрузки объекта или сможете найти его через конечную точку GET Objects Meta). Также существует параметр permanently, который определяет, будет ли объект перемещен в корзину или нет. По умолчанию его значение равно false.

Запрос Postman DELETE Object: выделены object ID and permanently.

Как восстановить объект

Эндпоинт: Restore Object

Если вы удалили объект и отправили его в корзину (подробнее об этом можно посмотреть в разделе про эндпоинт «Delete Object»), вы можете его восстановить. Вам необходимо знать ID объекта (вы получите его в ответе во время загрузки объекта или сможете найти его с помощью эндпоинта GET List of object types). Замените :id в адресной строке на этот ID.

Запрос Postman GET Object Usages: выделены object ID.

Как определить, какие профили используют этот объект?

Эндпоинт: Object Profile Usages

Для этой цели можно использовать запрос GET Object Profile Usages. Укажите ID вашего объекта (вы получите его в ответе во время загрузки объекта или сможете найти его с помощью конечной точки GET List of object types) и замените Object ID в строке эндпоинта.

Запрос Postman POST Restore Object: выделены Object ID.

Как получить статистику об объектах

Эндпоинт: Get Statistics for Objects

Запрос GET Statistics for Objects предоставляет информацию об объектах: сколько места они занимают, доступны ли они пользователю и т.д. Для выполнения этого API-запроса достаточно токена автоматизации.

Запрос Postman GET Statistics for Objects: выделены storage statistics in the response.

Как получать метаданные об объектах

Эндпоинт: Get Objects meta

Этот эндпоинт отображает различную информацию, связанную с профилями, такую как ID, дату создания, имя и т. д. Он имеет различные параметры сортировки, которые могут помочь в поиске нужных объектов. Имейте в виду, что необходимо установить значения limit и offset . Вы можете добавлять и изменять значения параметров на вкладке «Params».

Запрос Postman GET List Objects: выделены limit and offset.

Как получить метаданные о конкретном профиле

Эндпоинт: Get Objects meta by ID

Если вам нужна информация об одном конкретном объекте, вы можете использовать этот эндпоинт вместо GET Object Meta. Вам нужно указать ID объекта для запроса (вы получите его в ответе во время загрузки объекта или сможете найти его через эндпоинт GET Object Meta). Замените значение :id на него.

Запрос Postman GET Object Meta: выделены object ID.

Как вывести список объектов, использованных в профиле.

Эндпоинт: List of Objects per profile

Принцип использования похожий, как и у GET Object Profile Usages. Однако в этом запросе предоставляется список объектов, используемых в конкретном профиле. Необходимо указать ID профиля в параметре profile_id (вот как его получить: Как копировать ID профиля в Multilogin ).

Запрос Postman GET List of Objects by Profile: выделены profile_id.

Убедитесь, что тип запроса установлен как GET.

Преобразование типа хранилища

Как преобразовать облачный объект в локальный

Эндпоинт: Cloud to Local

Этот эндпоинт используется для передачи локального объекта в облачное хранилище. Вам необходимо задать для него значение object_id (его можно получить с помощью запроса GET Objects Meta).

Запрос Postman POST Cloud to Local: выделены object_id.

Как преобразовать локальный объект в облачный

Конечная точка: Local to Cloud

Этот эндпоинт используется для передачи объекта из локального хранилища в облачное. Необходимо директорию объекта в параметре object_path и задать object_id (его можно получить с помощью запроса GET Objects Meta).

Запрос Postman POST Local to Cloud: выделены object_path and object_id.

Управление расширениями

Эти эндпоинты связаны с функцией менеджера расширений, которая упоминается в следующей статье: Как установить браузерные расширения в Multilogin (через менеджер расширений).

Как создать объект расширения

Конечная точка: Create Extension

Запрос POST Create Extension создает объект на основе ссылки на расширение. Установите значения browser_type (Mimic или Stealthfox ), storage_type (cloud или local) и url для расширения (для Mimic можно взять из Chrome Web Store, а для Stealthfox — из Firefox Add-ons).

Запрос Postman POST Create Extension: выделены browser_type, storage_type and url.

Если расширение установлено локально на вашем устройстве хранения, воспользуйтесь следующим эндпоинтом: POST Upload Object.

Как включить и отключить расширение

Эндпоинты:

Эти эндпоинты можно использовать для установки расширений в профили или их удаления. Структура для обоих случаев схожа: в строке эндпоинтов укажите ID объекта расширения (его можно получить с помощью POST Upload Object , POST Create Extension или GET Objects Meta), а во вкладке Body — ID профилей (как их получить: Как копировать ID профиля в Multilogin).

Запрос Postman POST Enable Extension: выделены object ID and profile IDs.

Будьте в курсе

Следите за обновлениями, общайтесь и смотрите примеры.

Открыть новостиКанал в TelegramЗадать вопросЧат в TelegramПосмотреть кейсыСообщество в Discord