# API Local de Telefone em Nuvem Gerencie instâncias de telefones em nuvem através da API Local do MoreLogin. URL base: http://127.0.0.1:40000. A API Local é executada em sua máquina junto com o aplicativo desktop MoreLogin. Todas as solicitações devem ser originadas da mesma máquina. Version: 2026-09-05 ## Servers Endpoint local do MoreLogin ``` http://127.0.0.1:40000 ``` ## Security ## Download OpenAPI description - [API Local de Telefone em Nuvem](https://guide.morelogin.com/_bundle/@l10n/pt/API%20Reference/Cloud%20Phone/local-api.yaml) ## Cloud Phone Management - [POST /api/cloudphone/page](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/pageusingpost.md): Lista os Cloud Phones visíveis para a equipe autenticada, página por página. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. - **Observação**: telefones de todos os tipos d - [POST /api/cloudphone/create](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/createusingpost.md): Compra e provisiona um ou mais Cloud Phones. - **Pré-requisitos**: o plano precisa ter capacidade restante e a cota diária de criação não pode estar esgotada. `country`, `timezone` e `language` são va - [POST /api/cloudphone/powerOn](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/poweronusingpost.md): Liga um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar desligado no momento. É rejeitado quando o SKU foi retirado ou está em manutenção, quando o telefone está reservado por outro membro - [POST /api/cloudphone/powerOff](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/poweroffusingpost.md): Desliga um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar inicializando ou ligado. Ele não pode ser desligado enquanto estiver reservado por outro membro, nem enquanto houver em andamento - [POST /api/cloudphone/edit/batch](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/editbatchusingpost.md): Atualiza a configuração de um ou mais Cloud Phones. - **Pré-requisitos**: os telefones precisam pertencer à equipe. Os valores de região, idioma e coordenadas são validados por serviço, exatamente com - [POST /api/cloudphone/setProxy](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/setproxy.md): Vincula um proxy a um ou mais Cloud Phones. - **Pré-requisitos**: informe pelo menos um entre `ids` e `uniqueIds`. Os telefones precisam pertencer à sua equipe; **não** é necessário que estejam ligado - [POST /api/cloudphone/delete/batch](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/deleteusingpost.md): Libera um ou mais Cloud Phones. - **Pré-requisitos**: os telefones não podem estar em transferência e a equipe não pode ter pedidos em aberto referentes a eles. O telefone não precisa estar desligado. - [POST /api/cloudphone/newMachine](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/onenewusingpost.md): Substitui a identidade de dispositivo de um Cloud Phone no lugar (novo dispositivo em um clique). - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da e - [POST /api/cloudphone/info](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/infousingpost.md): Retorna o detalhe completo de um único Cloud Phone, incluindo nomes de grupo e de etiquetas. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. - **Uso**: é o endpoint princip - [POST /api/cloudphone/queryByAndroidId](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/querybyandroidid.md): Busca um Cloud Phone pelo Android ID informado pelo dispositivo. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. O telefone não precisa estar ligado. - **Retorna**: a mesma - [POST /api/cloudphone/enableRoot](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/enableroot.md): Liga ou desliga a chave global de ROOT de um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível com dispositivos compa - [POST /api/cloudphone/screenCap](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/screencap.md): Captura a tela do Cloud Phone e retorna uma URL de download. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível apenas com disposit - [POST /api/cloudphone/screenCapBase64](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/screencapbase64.md): Captura a tela do Cloud Phone e retorna a imagem embutida como base64. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. **Compatível apenas - [POST /api/cloudphone/brand/models](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/cloud-phone-management/listcloudphonebrandsandmodelslocal.md): Lista as marcas e modelos de dispositivo que um SKU de Cloud Phone suporta. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. Nenhum Cloud Phone é envolvido. - **Uso**: escol ## Live Streaming - [POST /api/cloudphone/live/start](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/live-streaming/startcloudphonelivestreaminglocal.md): Inicia a transmissão ao vivo de um MP4 já enviado em um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe, e o serviço dele preci - [POST /api/cloudphone/live/status](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/live-streaming/getcloudphonelivestreamingstatuslocal.md): Informa se um Cloud Phone está transmitindo ao vivo neste momento. - **Pré-requisitos**: o telefone precisa pertencer à sua equipe e o serviço dele precisa suportar transmissão ao vivo. Diferente do i - [POST /api/cloudphone/live/end](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/live-streaming/stopcloudphonelivestreaminglocal.md): Encerra a transmissão ao vivo em um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe, e o serviço dele precisa suportar transmis ## Account & Quotas - [GET /api/balance](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/account-and-quotas/getaccountandcloudphonequotaslocal.md): Retorna o saldo da carteira da equipe e as franquias de uso do Cloud Phone. - **Pré-requisitos**: o membro que chama precisa da permissão de custos. A carteira é consultada por equipe, então os número ## ADB - [POST /api/cloudphone/updateAdb](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/adb/updateadbusingpost.md): Ativa ou desativa o acesso ADB em um ou mais Cloud Phones. - **Pré-requisitos**: apenas telefones cujo SKU suporta ADB são considerados; se nenhum dos informados atender ao requisito, a chamada é reje - [POST /api/cloudphone/batchAdbInfo](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/adb/batchadbinfo.md): Obtém os dados de conexão ADB de até 200 Cloud Phones. - **Pré-requisitos**: os telefones precisam pertencer à sua equipe. **Não** é necessário que estejam reservados por você. Os dados só são obtidos - [POST /api/cloudphone/exeCommand](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/adb/executeshellcommand.md): Executa um comando de shell em um Cloud Phone e retorna a saída. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. - **Efeito**: depende inte ## Files - [POST /api/cloudphone/uploadFile](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/files/fileuploadusing.md): Envia um arquivo local direto para um Cloud Phone (fluxo multipart legado). - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. O código de env - [POST /api/cloudphone/upload/file/signedUrl](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/files/getcloudphoneuploadsignedurllocal.md): Solicita uma URL pré-assinada para enviar um arquivo que um Cloud Phone vai receber. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. - **Co - [POST /api/cloudphone/upload/file](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/files/uploadcloudphonefilebyurllocal.md): Registra um arquivo já enviado para que o Cloud Phone o baixe. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe, e **o objeto já precisa exis - [POST /api/cloudphone/upload/file/result](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/files/getcloudphoneuploadresultlocal.md): Consulta o status do envio de um arquivo para um Cloud Phone. - **Valores**: `0` enviando, `1` concluído, `2` falhou. - **Resultado vazio**: quando o `fileId` não é encontrado, a chamada ainda tem suc - [POST /api/cloudphone/download](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/files/downloadcloudphonefilelocal.md): Baixa um arquivo de um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. - **Efeito**: o serviço percorre primeiro o diretório p - [POST /api/cloudphone/download/result](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/files/getcloudphonedownloadresultlocal.md): Consulta o status do download de um arquivo a partir de um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Passe o `downId` re - [POST /api/cloudphone/setKeyBox](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/files/setcloudphonekeyboxlocal.md): Instala um certificado keybox em um Cloud Phone. - **Pré-requisitos**: `filePath` precisa apontar para um arquivo `.xml`, e o telefone precisa estar ligado e não pode estar reservado por outro membro ## Apps - [POST /api/cloudphone/app/install](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/installcloudphoneapplocal.md): Instala um app da biblioteca da equipe em um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. O app já precisa existir na bibli - [POST /api/cloudphone/app/page](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/listcloudphoneappslocal.md): Lista os apps que podem ser instalados em um Cloud Phone. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. Nenhum Cloud Phone é envolvido, então o telefone não precisa estar - [POST /api/cloudphone/team/app/page](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/listteamcloudphoneappslocal.md): Lista a biblioteca de apps da própria equipe, incluindo os apps pré-instalados. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. - **Conteúdo**: uma fonte diferente de `/clo - [POST /api/cloudphone/app/installedList](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/listinstalledcloudphoneappslocal.md): Lista os apps atualmente instalados em um Cloud Phone. - **Pré-requisitos**: o telefone precisa pertencer à sua equipe. Diferente da maioria dos comandos de Cloud Phone, **não** é necessário que ele e - [POST /api/cloudphone/app/start](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/startcloudphoneapplocal.md): Inicia um app instalado em um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. - **Conclusão**: a resposta confirma que o coman - [POST /api/cloudphone/app/restart](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/restartcloudphoneapplocal.md): Reinicia um app em um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. **Não é verificado se o app está instalado**: um pacote - [POST /api/cloudphone/app/stop](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/stopcloudphoneapplocal.md): Encerra um app em execução em um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Não é verificado se o app está instalado nem - [POST /api/cloudphone/app/uninstall](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/uninstallcloudphoneapplocal.md): Desinstala um app de um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. - **Efeito**: despacha a desinstalação e atualiza o re - [POST /api/cloudphone/app/openRoot](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/appopenroot.md): Concede ROOT a pacotes de apps específicos em um Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível com dispositivos c - [POST /api/cloudphone/app/setHideAccessibilityApp](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/apps/setcloudphoneaccessibilityapphiddenlocal.md): Oculta apps da lista do serviço de acessibilidade do Android em um ou mais Cloud Phones. - **Pré-requisitos**: de 1 a 100 identificadores de telefone e de 1 a 100 nomes de pacote. Os telefones precisa ## Schedules - [POST /api/cloudphone/rpa/template/market/page](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/listmarketplacerpatemplateslocal.md): Lista os modelos de RPA do mercado público. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. Os modelos são globais, não limitados à equipe. - **Localização**: títulos e des - [POST /api/cloudphone/rpa/template/personal/page](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/listpersonalrpatemplateslocal.md): Lista os modelos de RPA criados pela sua equipe. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. - **Conteúdo**: um repositório diferente do mercado, limitado à sua equipe, - [POST /api/cloudphone/rpa/task/page](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/listcloudphonerpataskslocal.md): Lista os agendamentos de RPA da equipe, página por página. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. - **Uso**: o `taskState` de cada agendamento é o sinal de conclus - [POST /api/cloudphone/rpa/task/save](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/savecloudphonerpatasklocal.md): Salvar tarefa agendada do telefone na nuvem. templateParameter Parameter Specification 1. **Parameter Source** Parameter keys must be extracted from the `parameter` field returned by the following API - [POST /api/cloudphone/rpa/onceTask/save](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/savecloudphonerpaonetimetasklocal.md): Salvar na nuvem do celular após a tarefa agendada. Especificação de Parâmetros do TemplateParameter 1. **Origem dos Parâmetros** As chaves dos parâmetros devem ser extraídas do campo `parameter` retor - [POST /api/cloudphone/rpa/task/cancel](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/cancelcloudphonerpatasklocal.md): Cancela um agendamento de RPA e todas as execuções dele que não foram finalizadas. - **Pré-requisitos**: o agendamento precisa existir na equipe. Um agendamento finalizado não pode ser cancelado; um j - [POST /api/cloudphone/rpa/subTask/page](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/listcloudphonerpasubtaskslocal.md): Lista as execuções individuais de RPA, página por página. - **Efeito**: nenhum. Somente leitura. É seguro repetir com recuo limitado. - **Valores de status**: `taskState` é `0` aguardando, `1` em exec - [POST /api/cloudphone/rpa/subTask/detail/{id}](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/getcloudphonerpasubtaskdetaillocal.md): Retorna o detalhe de uma única execução de RPA. - **Pré-requisitos**: a execução precisa pertencer à sua equipe. A chamada falha se a execução, o agendamento dela ou o Cloud Phone dela não existirem m - [POST /api/cloudphone/rpa/subTask/cancel/{id}](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/schedules/cancelcloudphonerpasubtasklocal.md): Cancela uma única execução de RPA sem mexer no agendamento dela. - **Pré-requisitos**: o registro da execução precisa existir na equipe. Uma execução finalizada não pode ser cancelada; uma já cancelad ## Touch - [POST /api/cloudphone/touch/click](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/touch/touchclick.md): Toca em um ponto da tela do Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível apenas com modelos compatíveis; os dema - [POST /api/cloudphone/touch/doubleClick](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/touch/touchdoubleclick.md): Toca duas vezes em um ponto da tela do Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível apenas com modelos compatíve - [POST /api/cloudphone/touch/longClick](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/touch/touchlongclick.md): Pressiona e mantém um ponto da tela do Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível apenas com modelos compatíve - [POST /api/cloudphone/touch/swipe](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/touch/touchswipe.md): Desliza entre dois pontos da tela do Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível apenas com modelos compatíveis - [POST /api/cloudphone/touch/drag](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/touch/touchdrag.md): Arrasta entre dois pontos da tela do Cloud Phone. - **Pré-requisitos**: o telefone precisa estar ligado e não pode estar reservado por outro membro da equipe. Compatível apenas com modelos compatíveis ## Monthly Billing - [GET /api/cloudphone/monthly/skus](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/monthly-billing/listmonthlycloudphoneskus.md): Retorna os produtos mensais de Cloud Phone disponíveis para a equipe. - **Efeito**: nenhum; não reserva capacidade nem cobra o saldo. É somente leitura. - **Uso**: passe o `skuId` retornado para [`/ap - [POST /api/cloudphone/monthly/activate](https://guide.morelogin.com/pt/api-reference/cloud-phone/local-api/monthly-billing/activatemonthlycloudphones.md): Compra e ativa de 1 a 10 Cloud Phones mensais por 30 dias. - **Aviso de cobrança**: **esta operação debita realmente o saldo da equipe.** - **Permissão**: o membro precisa de **Gestão de despesas/paga