Хотите создать резервную копию отдельных частей профиля браузера, например, файлов cookie или расширений? Функции объектного хранилища помогут вам в этом. Загружая сегменты данных браузера, вы защитите их от потери.

В этой статье мы разберемся какие эндпоинты API можно использовать для объектов вашего профиля.

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

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

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

Для выполнения запроса достаточно токена (стандартного (bearer) или токена автоматизации).

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

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

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

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

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

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

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

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

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

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

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

Эндпоинты, связанные со статистикой объектов

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

 

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

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

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

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

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

 

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

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

 

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

Эндпоинты:

• Enable Extension
• Disable Extension

 

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