Cloud Storage

O Cloud Storage é um espaço de arquivos no nível da equipe para guardar arquivos que precisam ser reutilizados nos fluxos de automação do MoreLogin. Use-o para enviar um arquivo uma vez, organizá-lo com tags, encontrá-lo depois e excluir o que não é mais necessário.

Ele é separado das APIs de transferência de arquivos do Cloud Phone. As APIs de arquivo do Cloud Phone movem arquivos para dentro ou para fora de uma instância de aparelho específica. As APIs do Cloud Storage gerenciam a biblioteca de arquivos compartilhada antes de um arquivo ser usado por aparelhos, agendamentos, modelos de RPA ou outra lógica de automação.

• Envie APKs, arquivos de mídia, documentos ou recursos de teste uma vez e reutilize-os na automação.
• Mantenha os arquivos organizados por cliente, campanha, versão do aplicativo, ambiente ou fluxo.
• Crie um seletor de arquivos na sua ferramenta interna chamando a API de paginação com filtros de nome e tag.
• Limpe em lote os arquivos expirados ou não usados depois que um fluxo termina.
• Sincronize um sistema externo de recursos com o MoreLogin criando tags e anexando-as aos arquivos enviados.

Para detalhes de autenticação, veja Autenticação.

Os uploads do Cloud Storage usam um fluxo de URL pré-assinada. Seu código não envia o arquivo binário diretamente para a API do MoreLogin.

1. Chame Solicitar em lote URLs de upload pré-assinadas com uma lista de nomes de arquivo (com extensão).
2. Para cada item retornado, envie o arquivo binário para presignedUrl com PUT por HTTPS.
3. Chame Confirmar a conclusão do upload com o id do arquivo retornado.
4. Use Paginar arquivos do cloud storage ou Consultar tags do arquivo para verificar e exibir o arquivo enviado.

# 1. Request a presigned upload URL
curl -X POST "https://api.morelogin.com/cloudstorage/upload/init" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileNames": ["example.jpg"]
  }'

# 2. Upload file content to the returned presignedUrl
curl -X PUT "PRESIGNED_URL_FROM_RESPONSE" \
  -H "Content-Type: image/jpeg" \
  --data-binary "@example.jpg"

# 3. Confirm upload completion (id from step 1 response)
curl -X POST "https://api.morelogin.com/cloudstorage/upload/complete" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 1800000000000001
  }'

Para a Local API, mantenha o mesmo corpo de requisição e substitua o caminho por http://127.0.0.1:40000/api/cloudstorage/....

Depois que um arquivo é enviado e confirmado, os parâmetros de modelo do RPA do Cloud Phone podem referenciá-lo pelo ID de arquivo do Cloud Storage. Use o protocolo de arquivo em nuvem do MoreLogin em vez de uma URL de download pública externa:

morelogin://cloudfile?ids=1,2

ids é uma lista de IDs de arquivo do Cloud Storage separados por vírgula. Use apenas vírgulas inglesas, sem espaços. Você pode obter os IDs de arquivo na resposta de conclusão do upload ou em Paginar arquivos do cloud storage.

Arquivo único:

morelogin://cloudfile?ids=1800000000001001

Vários arquivos:

morelogin://cloudfile?ids=1800000000001001,1800000000001002

Quando o parâmetro do RPA é de mídia ou arquivo, mantenha os metadados obrigatórios __Extra__ e defina o valor do parâmetro como o URI do protocolo de arquivo em nuvem:

{
  "__Extra__": {
    "videoDownloadUrl": { "name": "video.mp4", "size": 204800000 }
  },
  "videoDownloadUrl": "morelogin://cloudfile?ids=1,2"
}

Isso é útil para tarefas agendadas de RPA do Cloud Phone, modelos do marketplace, modelos pessoais e qualquer parâmetro de nó de RPA que espere um arquivo enviado reutilizável. O runtime do RPA resolve o arquivo a partir do Cloud Storage do MoreLogin, então o arquivo não precisa ser exposto em uma URL HTTPS pública.

Este exemplo envia video.mp4 para o Cloud Storage, anexa uma tag e depois cria uma tarefa única de RPA do Cloud Phone que usa o arquivo enviado no parâmetro de modelo videoDownloadUrl.

O exemplo usa caminhos da Local API. Para a Open API, mantenha os mesmos corpos de requisição e substitua:

• http://127.0.0.1:40000/api/cloudstorage/... por https://api.morelogin.com/cloudstorage/...
• http://127.0.0.1:40000/api/cloudphone/... por https://api.morelogin.com/cloudphone/...

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/tag/create" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "tagName": "RPA Assets"
  }'

Salve o id da tag retornada, por exemplo 1800000000000101.

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/upload/init" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileNames": ["video.mp4"]
  }'

Salve o id do arquivo retornado e o presignedUrl.

Envie o conteúdo do arquivo para presignedUrl. Essa requisição vai para a URL do object storage retornada na etapa anterior, e não para a API do MoreLogin.

curl -X PUT "PRESIGNED_URL_FROM_RESPONSE" \
  -H "Content-Type: video/mp4" \
  --data-binary "@video.mp4"

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/upload/complete" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "id": 1800000000000001
  }'

Salve o ID de arquivo do Cloud Storage retornado, por exemplo 1800000000001001.

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/file/tag/add" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": 1800000000001001,
    "tagIds": [1800000000000101]
  }'

Se a sua resposta de conclusão do upload não incluir o ID do arquivo diretamente, consulte os arquivos por página:

curl -X POST "http://127.0.0.1:40000/api/cloudstorage/file/page" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pageNo": 1,
    "pageSize": 20,
    "fileName": "video",
    "tagIds": [1800000000000101]
  }'

Use o ID de arquivo do Cloud Storage no protocolo de arquivo em nuvem do MoreLogin:

morelogin://cloudfile?ids=1800000000001001

Para um parâmetro de modelo de RPA chamado videoDownloadUrl, monte o objeto JSON assim:

{
  "__Extra__": {
    "videoDownloadUrl": {
      "name": "video.mp4",
      "size": 204800000
    }
  },
  "videoDownloadUrl": "morelogin://cloudfile?ids=1800000000001001"
}

Depois escape-o como string JSON para templateParameter:

"{\"__Extra__\":{\"videoDownloadUrl\":{\"name\":\"video.mp4\",\"size\":204800000}},\"videoDownloadUrl\":\"morelogin://cloudfile?ids=1800000000001001\"}"

Antes de criar a tarefa, obtenha cloudPhoneId na API de listagem do Cloud Phone e templateId na API de listagem de modelos do marketplace ou pessoais.

curl -X POST "http://127.0.0.1:40000/api/cloudphone/rpa/onceTask/save" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "cloudPhoneId": 1678331966138097,
    "scheduleName": "Upload video from Cloud Storage",
    "templateId": 1678347487160256,
    "templateParameter": "{\"__Extra__\":{\"videoDownloadUrl\":{\"name\":\"video.mp4\",\"size\":204800000}},\"videoDownloadUrl\":\"morelogin://cloudfile?ids=1800000000001001\"}",
    "description": "Use a Cloud Storage video file in a one-time Cloud Phone RPA task"
  }'

Consulte a lista de tarefas ou de subtarefas de RPA do Cloud Phone para verificar o status de execução:

curl -X POST "http://127.0.0.1:40000/api/cloudphone/rpa/task/page" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "pageNo": 1,
    "pageSize": 20,
    "taskName": "Upload video from Cloud Storage"
  }'

O ponto principal é que a tarefa de RPA recebe videoDownloadUrl como morelogin://cloudfile?ids=.... O MoreLogin resolve o arquivo a partir do Cloud Storage em tempo de execução, então sua integração não precisa hospedar o arquivo em uma URL pública.

Tags são metadados reutilizáveis para arquivos do cloud storage. Um arquivo pode ter várias tags.

• Use Criar tag de arquivo do cloud storage para criar tags como Invoices, APK, Customer A ou RPA Assets.
• Use Definir tags do arquivo quando quiser sobrescrever todas as tags de um arquivo.
• Use Adicionar tags ao arquivo quando quiser acrescentar sem remover as tags existentes.
• Use Consultar todas as tags de arquivo do cloud storage para montar filtros de tag na sua interface.
• Use Consultar tags do arquivo para mostrar quais tags estão nos arquivos selecionados.

Exemplo: acrescentar uma tag a um arquivo sem remover as que ele já tem.

curl -X POST "https://api.morelogin.com/cloudstorage/file/tag/add" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "fileId": 1800000000001001,
    "tagIds": [1800000000000103]
  }'

Nota: os caminhos da Local API usam o prefixo /api/. Os da Open API o omitem.