Pular para o conteúdo
MultiloginCentral de ajuda

Visão geral das solicitações API para armazenamento de objetos

No Multilogin, os endpoints da Object Storage API permitem enviar, baixar, excluir, restaurar, inspecionar e converter objetos armazenados, como cookies, extensões, modelos de perfil, senhas, scripts de automação e modelos de parâmetros de inicialização.

➡️ No Postman, abra “Multilogin API” → “Object Storage” → adicione seu token de automação em “Authorization” → “Bearer Token” → escolha o endpoint. Mantenha o aplicativo Multilogin aberto quando a ação exigir a inicialização de um perfil.

Comece com “Get list of object types” para encontrar o ID do tipo de objeto. Depois, use o endpoint adequado para gerenciar o objeto, verificar onde ele é usado, consultar metadados ou estatísticas, converter o tipo de armazenamento ou gerenciar objetos de extensão.

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 ”.

Certifique-se de que o aplicativo esteja iniciado, pois isso permite iniciar perfis.

Lista de tipos de objetos

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.

Adicione seu token de automação em “Authorization” → “Bearer Token”.

Requisição Postman GET List of Object Types com Authorization → Bearer Token em destaque.

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.

Requisição Postman POST Upload Object com object_type, object_path, storage_type em destaque.

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.

Requisição Postman POST Create and Upload Object com object_name, object_extension em destaque.

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.

Requisição Postman GET Download Object com object ID in the endpoint URL em destaque.

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.

Requisição Postman DELETE Object com object ID and permanently em destaque.

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.

Requisição Postman GET Object Usages com object ID em destaque.

Como detectar quais perfis usam o objeto

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.

Requisição Postman POST Restore Object com Object ID em destaque.

Como obter estatísticas para objetos

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. O token de automação é suficiente para executar essa solicitação de API.

Requisição Postman GET Statistics for Objects com storage statistics in the response em destaque.

Como receber metadados sobre objetos

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”.

Requisição Postman GET List Objects com limit and offset em destaque.

Como receber metadados sobre um perfil específico?

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.

Requisição Postman GET Object Meta com object ID em destaque.

Como imprimir a lista de objetos usados no perfil?

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).

Requisição Postman GET List of Objects by Profile com profile_id em destaque.

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).

Requisição Postman POST Cloud to Local com object_id em destaque.

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).

Requisição Postman POST Local to Cloud com object_path and object_id em destaque.

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

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).

Requisição Postman POST Create Extension com browser_type, storage_type and url em destaque.

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

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.

Requisição Postman POST Enable Extension com object ID and profile IDs em destaque.

Fique por dentro

Veja as últimas atualizações, troque dicas e explore casos de uso práticos.

Novidades do produtoCanal no TelegramPergunte a outrosChat no TelegramExplore casos de usoComunidade no Discord