对象存储API请求概述
想备份浏览器配置文件中的特定部分,例如 Cookie 或扩展程序?对象存储功能可以帮您做到这一点。通过上传浏览器数据片段,您可以防止数据丢失。
您将了解哪些API端点可用于您的配置文件对象。
请注意,本文仅为功能概述,对配置的解释将较为简略。我们假设您已掌握 Postman 的基本使用方法。建议您在阅读本文之前先阅读以下文章。
为了方便您使用,这些接口已按类别划分。所有接口都位于“对象存储”文件夹的“ Multilogin API ”集合中。
对象类型列表
Endpoint: Get list of object types
这可能是您的第一个API请求,建议提前调用。GET List of object types 请求会返回多种分类,用于对象归类。这些类型包括扩展程序、Cookie、配置文件模板、密码、自动化脚本和启动参数模板等。

对象上传、下载和删除
如何上传对象
Endpoint: Upload Object
POST Upload Object上传对象支持您将对象上传到存储。您需要设置对象类型ID (可通过以下请求获取: GET List of object types)、对象路径(您存放对象的目录)和存储类型(云端或本地)。此外,还有一些可选参数,例如对象元数据(对象的描述)和加密选项。

如何创建和上传对象
Endpoint: Create and Upload Object
POST Create and Upload Object创建和上传对象不仅可以用于上传文件,还支持在API请求内部创建新文件。例如,如果您通过API导出了 cookie,使用该接口会十分便捷。它与POST Upload Object具有相同的参数,同时额外新增了object_name文件名参数和object_extension文件后缀参数。

如何下载该对象
Endpoint: Download Object
如果需要从云端下载对象,可以使用GET Download Object 请求。您需要知道对象的ID (可以在对象上传过程中收到响应,也可以通过 GET Objects Meta端点找到)。将端点地址栏中的<id_upload>替换为该 ID。

如何删除对象
Endpoint: Delete Object
您可以使用GET Delete Object 请求从存储中删除对象。您需要提供对象的ID (您可以在上传对象时收到响应,也可以通过GET Objects Meta端点找到它)。此外,还有一个参数permanently存在,用于设置对象是否直接彻底删除、不移入回收站。该参数的默认值为false 。

如何恢复对象
Endpoint: Restore Object
如果您已删除对象并将其移至回收站(请参阅“ 对象删除”章节),则可以恢复该对象。您需要知道对象的ID (您可以在上传对象时收到响应,或者通过“GET List of object types”端点找到它)。将端点栏中的:id替换为该 ID。

对象统计信息相关端点
如何检测哪些配置文件使用了该对象
Endpoint: Object Profile Usages
可以使用GET Object Profile Usages对象配置文件使用情况请求来实现此目的。设置您的对象ID (您可以在对象上传期间收到响应,或者可以通过GET List of object types端点找到它),并将端点栏中的Object ID替换为相应值。

如何获取对象的统计信息
Endpoint: Get Statistics for Objects
GET Statistics for Objects 可提供对象相关数据,包括对象占用存储空间大小、是否对用户可用等信息。仅使用Bearer令牌或自动化令牌,即可调用该API接口。

如何接收关于对象的元信息
Endpoint: Get Objects meta
该接口可展示配置文件的各类相关信息,包含 ID、创建日期、名称等。接口支持多种排序参数,方便您检索所需对象。请注意,需要设置limit和offset值。您可以在“参数”标签页中添加并调整各项参数数值。

如何获取特定配置文件的元信息
Endpoint: Get Objects meta by ID
如需查询单个指定对象的信息,可使用本接口代替GET Object Meta端点。您需要为请求设置对象ID (您可以在对象上传期间收到响应,也可以通过GET Objects Meta端点找到它)。将:id值替换为该 ID。

如何打印配置文件中使用的对象列表
Endpoint: List of Objects per profile
与GET Object Profile Usages对象配置文件用法类似,但会返回指定配置文件里所用到的对象列表。您需要在profile_id参数中指定配置文件ID (获取方法请参见: 如何在Multilogin中复制配置文件ID )。

请确保请求类型设置为GET 。
存储类型转换
如何将云对象转换为本地对象
Endpoint: Cloud to Local
此接口用于将本地对象传输到云存储。您需要为其设置object_id值(您可以通过GET Objects Meta获取该值)。

如何将本地对象转换为 CloudOne 对象
Endpoint: Local to Cloud
此接口用于将对象从本地存储传输到云存储。您需要在object_path参数中设置对象的目录,并设置object_id (您可以通过GET Objects Meta获取)。

推广管理
与扩展管理器功能相关,如下文所述: 如何在Multilogin中安装浏览器扩展(扩展管理器方法)。
如何创建扩展对象
Endpoint: Create Extension
POST创建扩展程序会根据扩展程序链接创建一个对象。设置扩展程序的browser_type ( Mimic或Stealthfox )、 storage_type (cloud 或 local)和url值( Mimic来自Chrome网上应用店, Stealthfox来自Firefox 附加组件)。

如果您的存储设备上本地有扩展程序,请参考以下端点: POST 上传对象。
如何启用和禁用扩展程序
Endpoints:
您可以使用这些端点为配置文件提供扩展程序,反之亦然。两者的结构类似:在端点栏中设置扩展程序对象ID (您可以通过POST Upload Object 、 POST Create Extension或GET Objects Meta获取),并在正文选项卡中设置配置文件ID (获取方法请参见: 如何在Multilogin中复制配置文件ID)。
