Visão geral das solicitações API para armazenamento de objetos
Deseja fazer backup de partes específicas do seu perfil de navegador, como cookies ou extensões? Os recursos de armazenamento de objetos podem te ajudar com isso. Ao fazer o upload de segmentos de dados do navegador, você os protege contra perda.
Você aprenderá quais endpoints API pode usar para seus objetos de perfil.
Lembre-se de que esta é uma visão geral dos recursos e as explicações sobre sua configuração serão breves. Pressupõe-se que você já saiba usar o Postman em um nível básico. Recomendamos a leitura dos artigos abaixo antes de prosseguir.
Para sua conveniência, os endpoints estão divididos em categorias. Todos eles estão disponíveis na pasta “Object Storage”, coleção “ Multilogin API ”.
Lista de tipos de objetos
Endpoint: Get list of object types
Pode ser a primeira requisição API, o que é recomendável fazer com antecedência. GET List of object types fornece várias categorias, que são usadas para a classificação de objetos. Os tipos incluem diversas categorias, como extensões, cookies, modelos de perfil, senhas, scripts de automação e modelos de parâmetros de inicialização.
Um token tipo bearer (ou de automação) é suficiente para executar a solicitação.

Upload, download e exclusão de objetos
Como fazer o upload do objeto
Endpoint: Upload Object
O método POST Upload Object permite que você carregue um objeto para o armazenamento. Você precisa definir o ID do tipo de objeto (que pode ser obtido através da seguinte requisição: GET List of object types), o caminho do objeto (diretório onde você deseja armazenar o objeto) e o tipo de armazenamento (nuvem ou local). Existem também valores opcionais, como metadados do objeto (descrição do objeto) e criptografia.

Criação e upload de objeto
Endpoint: Upload Object
O método POST Create and Upload Object também pode auxiliar no upload de arquivos, mas oferece ainda a opção de criar um novo arquivo diretamente na requisição da API. Por exemplo, isso pode ser útil caso você tenha exportado cookies via API. Ele possui os mesmos parâmetros do método POST Upload Object, além dos parâmetros object_name para o nome do arquivo e object_extension para a extensão do arquivo.

Como realizar download de objeto
Endpoint: Download Object
Se precisar realizar o download do objeto da nuvem, você pode usar o método GET Download Object para isso. Você precisa saber o ID do objeto (você o recebe como resposta durante o upload do objeto ou pode encontrá-lo no endpoint GET Objects Meta). Substitua <id_upload> na barra de endpoints pelo ID.

Como excluir o objeto
Endpoint: Delete Object
Você pode usar o método GET Delete Object para remover objetos do armazenamento. É necessário informar o ID do objeto (você o recebe como resposta durante o upload do objeto ou pode encontrá-lo através do endpoint GET Objects Meta). Há também um parâmetro permanently que define se o objeto será movido para a lixeira ou não. Seu valor é definido como false por padrão.

Como restaurar o objeto
Endpoint: Restore Object
Se você removeu o objeto e o enviou para a lixeira (consulte o capítulo Exclusão de objetos para obter mais informações), poderá recuperá-lo. Você precisa saber ID do objeto (você o recebe como resposta durante o upload do objeto ou pode encontrá-lo por meio do endpoint GET List of object types). Substitua :id na barra de endpoint pelo ID do objeto.

Endpoints relacionados a estatísticas de objetos
Como detectar quais perfis usam o objeto
Endpoint: Object Profile Usages
O endpoint GET Object Profile Usages pode ser usado para essa finalidade. Defina ID do seu objeto (você o recebe como resposta durante o upload do objeto ou pode encontrá-lo através do endpoint GET List of object types) e substitua Object ID na barra do endpoint.

Como obter estatísticas para objetos
Endpoint: Get Statistics for Objects
O método GET Statistics for Objects fornece informações sobre os objetos: quanto espaço eles ocupam, se estão disponíveis para o usuário, etc. Um token Bearer/de automação é suficiente para executar essa solicitação API.

Como receber metadados sobre objetos
Endpoint: Get Objects meta
Este endpoint exibe diversas informações relacionadas a perfis, como ID, data de criação, nome, etc. Possui vários parâmetros de classificação que podem auxiliar na busca por objetos específicos. Lembre-se de que os valores limit e offset precisam ser definidos. Você pode adicionar e ajustar os valores dos parâmetros na aba “Parâmetros”.

Como receber metadados sobre um perfil específico?
Endpoint: Get Objects meta by ID
Se você precisar de informações sobre um objeto específico, pode usar este endpoint em vez de GET Object Meta. Você precisa definir o ID do objeto para a solicitação (você o recebe como resposta durante o upload do objeto ou pode encontrá-lo através do endpoint GET Objects Meta). Substitua o valor de :id pelo ID do objeto.

Como imprimir a lista de objetos usados no perfil?
Endpoint: List of Objects per profile
O caso de uso é semelhante ao de GET Object Profile Usages, mas fornece a lista de objetos usados no perfil específico. Você precisa informar o ID do perfil no parâmetro profile_id (veja como obtê-lo aqui: Como copiar ID de perfil no Multilogin).

Certifique-se de que o tipo de solicitação esteja definido como GET.
Conversão do tipo de armazenamento
Como converter um objeto na nuvem em um objeto local?
Endpoint: Cloud to Local
Este endpoint é usado para transferir um objeto local para o armazenamento em nuvem. Você precisa definir o valor object_id para ele (você pode obtê-lo através do método GET Objects Meta).

Como converter um objeto local em um objeto na nuvem?
Endpoint: Local to Cloud
Este endpoint é usado para transferir um objeto do armazenamento local para o armazenamento em nuvem. Você precisa definir o diretório do objeto no parâmetro object_path e definir object_id (que pode ser obtido através do método GET Objects Meta).

Gestão de extensão
Relacionado ao recurso de gerenciador de extensões, mencionado no seguinte artigo: Como instalar extensões de navegador no Multilogin (método do gerenciador de extensões).
Como criar um objeto de extensão
Endpoint: Create Extension
O método POST Create Extension cria um objeto a partir do link da extensão. Defina os valores browser_type (Mimic ou Stealthfox), storage_type (nuvem ou local) e url para a extensão (obtidos na Chrome Web Store para Mimic e nos complementos do Firefox para Stealthfox).

Se você tiver a extensão localmente em seu dispositivo de armazenamento, consulte o seguinte endpoint: POST Upload Object .
Como ativar e desativar extensões
Endpoints:
Você pode usar esses endpoints para disponibilizar extensões para perfis ou vice-versa. A estrutura para ambos é semelhante: defina o ID do objeto de extensão (você pode recebê-lo via POST Upload Object, POST Create Extension ou GET Objects Meta) na barra de endpoints e ID de perfil (veja como obtê-los aqui: Como copiar ID de perfil no Multilogin) na aba Corpo.
